TY - JOUR
T1 - Detailed design documentation, without the pain
AU - Ramsay, C. D.
AU - Parkes, S.
N1 - Copyright 2008 Elsevier B.V., All rights reserved.
PY - 2004/1/1
Y1 - 2004/1/1
N2 - Producing detailed forms of design documentation, such as pseudocode and structured flowcharts, to describe the procedures of a software system: (1) allows software developers to model and discuss their understanding of a problem and the design of a solution free from the syntax of a programming language, (2) facilitates deeper involvement of non-technical stakeholders, such as the customer or project managers, whose influence ensures the quality, correctness and timeliness of the resulting system, (3) forms comprehensive documentation of the system for its future maintenance, reuse and/or redeployment. However, such forms of documentation require effort to create and maintain. This paper describes a software tool which is currently being developed within the Space Systems Research Group at the University of Dundee which aims to improve the utility of, and the incentive for, creating detailed design documentation for the procedures of a software system. The rationale for creating such a tool is briefly discussed, followed by a description of the tool itself, a summary of its perceived benefits, and plans for future work.
AB - Producing detailed forms of design documentation, such as pseudocode and structured flowcharts, to describe the procedures of a software system: (1) allows software developers to model and discuss their understanding of a problem and the design of a solution free from the syntax of a programming language, (2) facilitates deeper involvement of non-technical stakeholders, such as the customer or project managers, whose influence ensures the quality, correctness and timeliness of the resulting system, (3) forms comprehensive documentation of the system for its future maintenance, reuse and/or redeployment. However, such forms of documentation require effort to create and maintain. This paper describes a software tool which is currently being developed within the Space Systems Research Group at the University of Dundee which aims to improve the utility of, and the incentive for, creating detailed design documentation for the procedures of a software system. The rationale for creating such a tool is briefly discussed, followed by a description of the tool itself, a summary of its perceived benefits, and plans for future work.
UR - http://www.scopus.com/inward/record.url?scp=22144469134&partnerID=8YFLogxK
M3 - Article
AN - SCOPUS:22144469134
SN - 0379-6566
SP - 142
EP - 149
JO - European Space Agency, (Special Publication) ESA SP
JF - European Space Agency, (Special Publication) ESA SP
IS - 570
ER -