Providing technical software documentation as a service - An industrial experience report
|G. Buchgeher, B. Dorninger, C. Klammer, A. Kern. Providing technical software documentation as a service - An industrial experience report. pages 581-590, DOI 10.1109/APSEC.2018.00073, 12, 2018.|
|Buch||Proceedings of the 25th Asia-Pacific Software Engineering Conference (APSEC 2018)|
Technical software documentation is an essential source of knowledge supporting many different software development activities and stakeholders. In this paper we report on use cases, existing documentation practices, and open challenges for technical software documentation in a company from the manufacturing domain. Further, we present an approach for automatically providing technical software documentation as a service. The approach has been validated in an industrial setting, i.e., we report on our experiences and lessons learned. Validation shows that while up-to-date and dynamically explorable documentation could be provided, the proposed solution failed in sufficiently supporting different stakeholders and their concerns i.e., it failed in providing sustainable documentation and knowledge preservation over time.