%0 Generic %1 garousi2013evaluating %A Garousi, G. %A Garousi, V. %A Moussavi, M. %A Ruhe, G. %A Smith, B. %B 17th International Conference on Evaluation and Assessment in Software Engineering %C Porto de Galinh, Brazil %D 2013 %K development orchestration quality.management %T Evaluating usage and quality of technical software documentation: an empirical study %U http://dl.acm.org/citation.cfm?id=2461003 %X Software documentation is an integral part of any software development process. However, software practitioners are often concerned about the lack of usage and quality of documentation in practice. Unfortunately, in many projects, practitioners find that software documentation artifacts are outdated, incomplete and sometimes not beneficial. Objective: Motivated by the needs of NovAtel Inc. (NovAtel), a world-leading company of GPS software systems, we propose in this paper an approach to analyze the usage and quality of software documentation in development and maintenance phases. Method: The approach incorporates inputs from automated analysis (e.g., mining of project's data) and also experts' opinion extracted from survey-based questionnaire. The approach has been designed based on the äction-research" approach and in close collaboration between industry and academia. Results: To evaluate the feasibility and usefulness of the proposed approach, we have applied it in an industrial setting and results are presented in this paper. One of the results is that, in the context of our case-study, usage of documentation for an implementation purpose is higher than the usage for maintenance purposes. Conclusion: It is concluded that the usage of documentation differs for various purposes and it depends on the type of the information needs as well as the task to be completed (e.g. development and maintenance). In addition, we identify the most important and relevant quality attributes which are critical to improving documentation quality.

@conference{garousi2013evaluating, abstract = {Software documentation is an integral part of any software development process. However, software practitioners are often concerned about the lack of usage and quality of documentation in practice. Unfortunately, in many projects, practitioners find that software documentation artifacts are outdated, incomplete and sometimes not beneficial. Objective: Motivated by the needs of NovAtel Inc. (NovAtel), a world-leading company of GPS software systems, we propose in this paper an approach to analyze the usage and quality of software documentation in development and maintenance phases. Method: The approach incorporates inputs from automated analysis (e.g., mining of project's data) and also experts' opinion extracted from survey-based questionnaire. The approach has been designed based on the "action-research" approach and in close collaboration between industry and academia. Results: To evaluate the feasibility and usefulness of the proposed approach, we have applied it in an industrial setting and results are presented in this paper. One of the results is that, in the context of our case-study, usage of documentation for an implementation purpose is higher than the usage for maintenance purposes. Conclusion: It is concluded that the usage of documentation differs for various purposes and it depends on the type of the information needs as well as the task to be completed (e.g. development and maintenance). In addition, we identify the most important and relevant quality attributes which are critical to improving documentation quality.}, added-at = {2015-01-05T14:53:20.000+0100}, address = {Porto de Galinh, Brazil}, author = {Garousi, G. and Garousi, V. and Moussavi, M. and Ruhe, G. and Smith, B.}, biburl = {https://www.bibsonomy.org/bibtex/28612a33d087c1c3c855dc330e9f3e663/ispma}, booktitle = {17th International Conference on Evaluation and Assessment in Software Engineering}, interhash = {011e7246a6c409acdeffa2f9169b6b8d}, intrahash = {8612a33d087c1c3c855dc330e9f3e663}, keywords = {development orchestration quality.management}, timestamp = {2015-04-17T15:14:18.000+0200}, title = {Evaluating usage and quality of technical software documentation: an empirical study}, url = {http://dl.acm.org/citation.cfm?id=2461003}, year = 2013 }