Formation of High-Quality Technical Documentation for Software
Олександр Марковець, Anna Synko · Visnyk of Vinnytsia Politechnical Institute · 2021
There is a problem that when creating software products, many companies pay attention to software development, rather than the formation of documentation. Therefore, the paper presents the importance of forming documentation for software. The concept of documentation quality in accordance with quality models, which are divided into basic and corporate, was considered. It was determined that the quality of the technical documentation for software systems is determined by three aspects: the content, presentation and representation. In accordance with the ISO/IEC-9126 standard, which consists of four components, life cycle documentation was presented, as well as its characteristics and sub-characteristics that can be used to analyze and evaluate the quality of documentation. This standard applies to software that is an information product. In turn, the information product can be considered as documentation. The quality of the information product can be assessed by measuring the following properties - internal, external properties, quality in use. But it should be noted that not all the characteristics and sub-characteristics that contain these quality models are applicable for the formation of useful-oriented documentation. Therefore, the following characteristics were chosen for the analysis: functional suitability (completeness and correctness) and quality in use (appropriateness recognizability, helpfulness, attractiveness). The structures of documents presented in the standard GOST 19.101-77, which are components of the program documentation as a type of technical documentation, were also given. Building quality software documentation requires constant monitoring and analysis of its correctness and quality, as well as the formation of modern requirements for its quality, so that the documentation was convenient, accessible to use and as informative as possible. Therefore, the problem of building quality technical documentation is urgent and relevant for further research.