Software Documentation Quality A Case Study for the Software Documentation of SIGEPE

被引:0
作者
da Silva, Waldeyr Mendes C. [1 ]
de Sousa, Rafael [2 ]
da Mata, Daniel Q. [2 ]
Araujo, Aleteia P. F. [3 ]
Holanda, Maristela [3 ]
dos Santos, Gileno Dias [4 ]
机构
[1] IFG, Goiania, Go, Brazil
[2] LATITUDE UnB, Brasilia, DF, Brazil
[3] Univ Brasilia UnB, Dept Ciencia Comp, Brasilia, DF, Brazil
[4] MPOG, Eixo Monumental, DF, Brazil
来源
2015 10TH IBERIAN CONFERENCE ON INFORMATION SYSTEMS AND TECHNOLOGIES (CISTI) | 2015年
关键词
Quality; Artifact; Software Documentation; SIGEPE; INSPECTION;
D O I
暂无
中图分类号
TP [自动化技术、计算机技术];
学科分类号
0812 ;
摘要
Requirements determine the correct construction of software and are frequently represented explicitly in the accompanying documentation in ways that vary according to the adopted software process. The documentation is typically written in natural language and can contain elements such as figures, tables or a more formal description. The quality assurance of artifacts written in natural language has advanced significantly since the mid-70s. SIGEPE makes use of checklists with criteria weighted by both form and content. The quality assurance team conducts periodic and individual checks on strategically selected projects. In little over a year, there was a noticeable improvement in the quality of the documentation and it was possible to identify the most common points of success and failure. This paper describes a Case Study to verify the quality of the elements of SIGEPE documentation.
引用
收藏
页数:6
相关论文
共 17 条
[1]  
[Anonymous], 2003, NBR ISO/IEC 9126-1
[2]  
[Anonymous], 2001, 145981 NBR ISOIEC
[3]  
Bayer J., 2006, 13 ANN IEEE INT S WO
[4]   A 2-PERSON INSPECTION METHOD TO IMPROVE PROGRAMMING PRODUCTIVITY [J].
BISANT, DB ;
LYLE, JR .
IEEE TRANSACTIONS ON SOFTWARE ENGINEERING, 1989, 15 (10) :1294-1304
[5]  
De Boer R. C., 2009, P 2009 ICSE WORKSH C
[6]   Knowledge-based approaches in software documentation: A systematic literature review [J].
Ding, Wei ;
Liang, Peng ;
Tang, Antony ;
van Vliet, Hans .
INFORMATION AND SOFTWARE TECHNOLOGY, 2014, 56 (06) :545-567
[7]   DESIGN AND CODE INSPECTIONS TO REDUCE ERRORS IN PROGRAM-DEVELOPMENT [J].
FAGAN, ME .
IBM SYSTEMS JOURNAL, 1976, 15 (03) :182-211
[8]  
Ferreira J. R., 2014, TERMO COOPERACAO TEC
[9]  
Junior R. T. de S, 2014, ACT 9 C IB SIST TECN, P609
[10]   AN IMPROVED INSPECTION TECHNIQUE [J].
KNIGHT, JC ;
MYERS, EA .
COMMUNICATIONS OF THE ACM, 1993, 36 (11) :51-61