%0 Conference Paper %1 1085331 %A de Souza, Sergio Cozzetti B. %A Anquetil, Nicolas %A de Oliveira, Káthia M. %B SIGDOC '05: Proceedings of the 23rd annual international conference on Design of communication %C New York, NY, USA %D 2005 %I ACM %K Documentation Me:MastersThesis Quality %P 68--75 %R http://doi.acm.org/10.1145/1085313.1085331 %T A Study of the Documentation Essential to Software Maintenance %U http://portal.acm.org/citation.cfm?id=1085313.1085331&coll=Portal&dl=ACM&CFID=1901909&CFTOKEN=99893798 %X Software engineering has been striving for years to improve the practice of software development and maintenance. Documentation has long been prominent on the list of recommended practices to improve development and help maintenance. Recently however, agile methods started to shake this view, arguing that the goal of the game is to produce software and that documentation is only useful as long as it helps to reach this goal.On the other hand, in the re-engineering field, people wish they could re-document useful legacy software so that they may continue maintain them or migrate them to new platform.In these two case, a crucial question arises: "How much documentation is enough?" In this article, we present the results of a survey of software maintainers to try to establish what documentation artifacts are the most useful to them. %@ 1-59593-175-9

@inproceedings{1085331, abstract = {Software engineering has been striving for years to improve the practice of software development and maintenance. Documentation has long been prominent on the list of recommended practices to improve development and help maintenance. Recently however, agile methods started to shake this view, arguing that the goal of the game is to produce software and that documentation is only useful as long as it helps to reach this goal.On the other hand, in the re-engineering field, people wish they could re-document useful legacy software so that they may continue maintain them or migrate them to new platform.In these two case, a crucial question arises: "How much documentation is enough?" In this article, we present the results of a survey of software maintainers to try to establish what documentation artifacts are the most useful to them.}, added-at = {2008-09-12T20:50:15.000+0200}, address = {New York, NY, USA}, author = {de Souza, Sergio Cozzetti B. and Anquetil, Nicolas and de Oliveira, K\'{a}thia M.}, biburl = {https://www.bibsonomy.org/bibtex/2d655a83a898cc71a9f509dafba67cecc/gron}, booktitle = {SIGDOC '05: Proceedings of the 23rd annual international conference on Design of communication}, description = {A study of the documentation essential to software maintenance}, doi = {http://doi.acm.org/10.1145/1085313.1085331}, interhash = {1e349d8386d6a0b6dd8599ada13eef0a}, intrahash = {d655a83a898cc71a9f509dafba67cecc}, isbn = {1-59593-175-9}, keywords = {Documentation Me:MastersThesis Quality}, location = {Coventry, United Kingdom}, pages = {68--75}, publisher = {ACM}, timestamp = {2008-09-22T20:18:00.000+0200}, title = {A Study of the Documentation Essential to Software Maintenance}, url = {http://portal.acm.org/citation.cfm?id=1085313.1085331&coll=Portal&dl=ACM&CFID=1901909&CFTOKEN=99893798}, year = 2005 }