Natural naming in software development and maintenance: Dissertation

Kari Laitinen

Research output: ThesisDissertationCollection of Articles

Abstract

The understandability of source programs and other types of software documents is important for several reasons. Software developers have to read documents written by their colleagues, and software maintainers often need to study old source programs about which they have no previous knowledge. Naming is one important factor that affects how understandable source programs are. In general, natural naming means avoiding abbreviations in software documentation. In the context of source programs, natural naming means that program elements such as variables, constants, tables, and functions should be named using whole natural words of a natural language with respect to the grammatical rules of the same natural language. This thesis introduces methods and tools to facilitate the use of natural naming in software development and maintenance. To support the use of natural naming in programming, source program elements are classified and specific naming rules provided for different program elements. An analytical name creation method is provided to make natural names in source programs consistent with written text in other types of software documents. Commonly used programming languages do not require any specific naming rules to be followed. For this reason, an experimental programming language is introduced in this thesis. The language is designed to support the use of natural naming. Existing source programs usually contain many abbreviated names. To make existing programs more maintainable, intelligent disabbreviation tools have been developed as part of this study. Disabbreviation means replacing abbreviated names with natural ones in existing source programs. The naming methods and tools have been evaluated by testing them in laboratory experiments and in practical software development and maintenance situations. The natural naming principles have been taught to software developers in different organizations. According to feedback received from users and the data collected in the experiments, natural naming is a promising approach to increase the understandability of software documents, and the methods and tools introduced in this thesis facilitate the use of this naming approach.
Original languageEnglish
QualificationDoctor Degree
Awarding Institution
  • University of Oulu
Supervisors/Advisors
  • Kerola, Pentti, Supervisor, External person
Place of PublicationEspoo
Publisher
Print ISBNs951-38-4781-0
Publication statusPublished - 1995
MoE publication typeG5 Doctoral dissertation (article)

Fingerprint

Computer software maintenance
Software engineering
Computer programming languages
Experiments
Feedback
Testing

Keywords

  • computer systems programs
  • computer programs
  • computers
  • programming
  • software development
  • software documentation
  • maintenance
  • naming
  • natural languages
  • human factors engineering
  • documents

Cite this

Laitinen, K. (1995). Natural naming in software development and maintenance: Dissertation. Espoo: VTT Technical Research Centre of Finland.
Laitinen, Kari. / Natural naming in software development and maintenance : Dissertation. Espoo : VTT Technical Research Centre of Finland, 1995. 103 p.
@phdthesis{9e0e18a8e2bf4a3e9ad5125329c5150e,
title = "Natural naming in software development and maintenance: Dissertation",
abstract = "The understandability of source programs and other types of software documents is important for several reasons. Software developers have to read documents written by their colleagues, and software maintainers often need to study old source programs about which they have no previous knowledge. Naming is one important factor that affects how understandable source programs are. In general, natural naming means avoiding abbreviations in software documentation. In the context of source programs, natural naming means that program elements such as variables, constants, tables, and functions should be named using whole natural words of a natural language with respect to the grammatical rules of the same natural language. This thesis introduces methods and tools to facilitate the use of natural naming in software development and maintenance. To support the use of natural naming in programming, source program elements are classified and specific naming rules provided for different program elements. An analytical name creation method is provided to make natural names in source programs consistent with written text in other types of software documents. Commonly used programming languages do not require any specific naming rules to be followed. For this reason, an experimental programming language is introduced in this thesis. The language is designed to support the use of natural naming. Existing source programs usually contain many abbreviated names. To make existing programs more maintainable, intelligent disabbreviation tools have been developed as part of this study. Disabbreviation means replacing abbreviated names with natural ones in existing source programs. The naming methods and tools have been evaluated by testing them in laboratory experiments and in practical software development and maintenance situations. The natural naming principles have been taught to software developers in different organizations. According to feedback received from users and the data collected in the experiments, natural naming is a promising approach to increase the understandability of software documents, and the methods and tools introduced in this thesis facilitate the use of this naming approach.",
keywords = "computer systems programs, computer programs, computers, programming, software development, software documentation, maintenance, naming, natural languages, human factors engineering, documents",
author = "Kari Laitinen",
note = "Project code: ELE3042",
year = "1995",
language = "English",
isbn = "951-38-4781-0",
series = "VTT Publications",
publisher = "VTT Technical Research Centre of Finland",
address = "Finland",
school = "University of Oulu",

}

Laitinen, K 1995, 'Natural naming in software development and maintenance: Dissertation', Doctor Degree, University of Oulu, Espoo.

Natural naming in software development and maintenance : Dissertation. / Laitinen, Kari.

Espoo : VTT Technical Research Centre of Finland, 1995. 103 p.

Research output: ThesisDissertationCollection of Articles

TY - THES

T1 - Natural naming in software development and maintenance

T2 - Dissertation

AU - Laitinen, Kari

N1 - Project code: ELE3042

PY - 1995

Y1 - 1995

N2 - The understandability of source programs and other types of software documents is important for several reasons. Software developers have to read documents written by their colleagues, and software maintainers often need to study old source programs about which they have no previous knowledge. Naming is one important factor that affects how understandable source programs are. In general, natural naming means avoiding abbreviations in software documentation. In the context of source programs, natural naming means that program elements such as variables, constants, tables, and functions should be named using whole natural words of a natural language with respect to the grammatical rules of the same natural language. This thesis introduces methods and tools to facilitate the use of natural naming in software development and maintenance. To support the use of natural naming in programming, source program elements are classified and specific naming rules provided for different program elements. An analytical name creation method is provided to make natural names in source programs consistent with written text in other types of software documents. Commonly used programming languages do not require any specific naming rules to be followed. For this reason, an experimental programming language is introduced in this thesis. The language is designed to support the use of natural naming. Existing source programs usually contain many abbreviated names. To make existing programs more maintainable, intelligent disabbreviation tools have been developed as part of this study. Disabbreviation means replacing abbreviated names with natural ones in existing source programs. The naming methods and tools have been evaluated by testing them in laboratory experiments and in practical software development and maintenance situations. The natural naming principles have been taught to software developers in different organizations. According to feedback received from users and the data collected in the experiments, natural naming is a promising approach to increase the understandability of software documents, and the methods and tools introduced in this thesis facilitate the use of this naming approach.

AB - The understandability of source programs and other types of software documents is important for several reasons. Software developers have to read documents written by their colleagues, and software maintainers often need to study old source programs about which they have no previous knowledge. Naming is one important factor that affects how understandable source programs are. In general, natural naming means avoiding abbreviations in software documentation. In the context of source programs, natural naming means that program elements such as variables, constants, tables, and functions should be named using whole natural words of a natural language with respect to the grammatical rules of the same natural language. This thesis introduces methods and tools to facilitate the use of natural naming in software development and maintenance. To support the use of natural naming in programming, source program elements are classified and specific naming rules provided for different program elements. An analytical name creation method is provided to make natural names in source programs consistent with written text in other types of software documents. Commonly used programming languages do not require any specific naming rules to be followed. For this reason, an experimental programming language is introduced in this thesis. The language is designed to support the use of natural naming. Existing source programs usually contain many abbreviated names. To make existing programs more maintainable, intelligent disabbreviation tools have been developed as part of this study. Disabbreviation means replacing abbreviated names with natural ones in existing source programs. The naming methods and tools have been evaluated by testing them in laboratory experiments and in practical software development and maintenance situations. The natural naming principles have been taught to software developers in different organizations. According to feedback received from users and the data collected in the experiments, natural naming is a promising approach to increase the understandability of software documents, and the methods and tools introduced in this thesis facilitate the use of this naming approach.

KW - computer systems programs

KW - computer programs

KW - computers

KW - programming

KW - software development

KW - software documentation

KW - maintenance

KW - naming

KW - natural languages

KW - human factors engineering

KW - documents

M3 - Dissertation

SN - 951-38-4781-0

T3 - VTT Publications

PB - VTT Technical Research Centre of Finland

CY - Espoo

ER -

Laitinen K. Natural naming in software development and maintenance: Dissertation. Espoo: VTT Technical Research Centre of Finland, 1995. 103 p.