Abstract
A few years ago we introduced a concept of "Embedded Software Documentation". This embedded documentation consists of special documenting structures referred to as Flagged Sentences. The purpose of Flagged Sentences is to assists us in reading and understanding software programs and their individual components during the maintenance of these programs and reuse of the components. This embedded documentation also helps us in functional decomposition of given problems and design of related computer programs and in ensuring the consistency of interfaces within these programs. After the introduction of Object Oriented Modeling and Design, we expanded the concept of Flagged Sentences to incorporate a specification and classification mechanism based on Object Oriented Modeling and Design. This paper presents new extensions to deal with both: UML language for modeling of problems and software components implementing solutions to these problems, and Unified Process for iterative development of software systems. The basic objective in the current expansion of Flagged Sentences is to accommodate Object Oriented Modeling using UML, and to communicate all the necessary information to tasks that are part of modern and efficient development environments for software production. The information is provided in a format that is easy to extract and automatically organize, classify and use. The information includes data about application domains, problems to be solved, the associated software systems being developed and the related documentations.
- Rumbaugh, J, et al "Object-Oriented Modeling and Design", Prentice Hall, 1991. Google ScholarDigital Library
- Rumbaugh, J, Jacpbson, and Booch, G, "The Unified Modeling Language Reference Manual", Addison Wesley, 2005. Google ScholarDigital Library
- Larman, C, "Applying UML and Patterns", Prentice Hall, 2005.Google Scholar
- Marovac, N, and Osburn, L, "HyperNet - A tool to choreograph world wide distributed hypermedia documents", Computers & Graphics, Vol. 16, No. 2, Pergamon Press, 1992.Google Scholar
- Marovac, N, "Software Development Environment based on HyperNet", ACM Software Engineering Notes, Vol. 22, No. 3, March 1997. Google ScholarDigital Library
- Marovac, N, "Guidelines for embedded Software Documentation", ACM Software Engineering Notes, Vol. 19, No. 2, April 1994. Google ScholarDigital Library
- Marovac, N, "Embedded Documentation for Semi-automatic Program Construction and Reuse". ACM Software Engineering Notes, Vol. 23, No. 3, 1998. Google ScholarDigital Library
- Riggins, L., A, "HyperNet - A Distributed Multimedia Information System", Master Thesis - Department of Computer Science, SDSU, Spring 2003.Google Scholar
Index Terms
- UML based embedded documentation for semi-automatic software development
Recommendations
Finding Reusable UML Sequence Diagrams Automatically
Software analysts create many artifacts, and until recently, these have been cumbersome to reuse. REUSER is a CASE (computer-aided software engineering) tool that lets analysts automatically retrieve related artifacts for reuse. Evaluations of REUSER ...
Guidelines for embedded software documentation
Embedded program documentation, i.e. documentation included in computer programs within program comments, typically does not follow any formal standards or conventions with regards to its contents and structure.Software development organizations do not ...
UML for systems engineering
The paper provides an introduction to the employment of Unified Modeling Language (UML) in systems engineering. The standard being developed for this purpose is the Systems Modeling Language (SysML) specification. This paper, while not dealing with ...
Comments