In the context of Open Source Software (OSS), the lack of project documentation is one of the most challenging problems that slows down the widespread diusion of OSS products. The diculty of providing up-to-date and reasonable documentation for OSS products relates to two main reasons. First, documenting development activities and technological issues is viewed as a tedious and unrewarding task. Second, data and information about an OSS project (such as source code, project plans, testing requirements, etc.) are scattered and shared via unstructured channels such as unocial forums and mailing lists. In this paper, we focus on technical documentation related to testing activities. In this context, the lack of documentation is exacerbated due to the use of the available testing methods that drastically increase code fragmentation. We propose T-doc, a tool that simplifies the generation of testing documentation. In particular, T-doc supports (1) the automatic generation of test cases documentation, (2) the generation of reports about test case results, and (3) the archiving of testing documents in central repositories. The automatic generation of documentation is facilitated by the adoption of built-in testing methods that simplify the aggregation of testing data. We apply the tool to the OSS RealEstate Java application to show the applicability and the real benets of our solution.

T-DOC: a tool for the automatic generation of testing documentation for OSS products

MORASCA, SANDRO;TAIBI, DAVIDE;TOSI, DAVIDE
2010-01-01

Abstract

In the context of Open Source Software (OSS), the lack of project documentation is one of the most challenging problems that slows down the widespread diusion of OSS products. The diculty of providing up-to-date and reasonable documentation for OSS products relates to two main reasons. First, documenting development activities and technological issues is viewed as a tedious and unrewarding task. Second, data and information about an OSS project (such as source code, project plans, testing requirements, etc.) are scattered and shared via unstructured channels such as unocial forums and mailing lists. In this paper, we focus on technical documentation related to testing activities. In this context, the lack of documentation is exacerbated due to the use of the available testing methods that drastically increase code fragmentation. We propose T-doc, a tool that simplifies the generation of testing documentation. In particular, T-doc supports (1) the automatic generation of test cases documentation, (2) the generation of reports about test case results, and (3) the archiving of testing documents in central repositories. The automatic generation of documentation is facilitated by the adoption of built-in testing methods that simplify the aggregation of testing data. We apply the tool to the OSS RealEstate Java application to show the applicability and the real benets of our solution.
2010
Par Agerfalk, Cornelia Boldyreff, Jesus M. Gonzalez-Barahona, Gregory R. Madey, and John Noll
Proceedings of The 6th International Conference on Open Source Systems, OSS 2010
9783642132438
The 6th International Conference on Open Source Systems, OSS 2010
Notre Dame, IN, USA
30 maggio- 2 giugno 2010
File in questo prodotto:
Non ci sono file associati a questo prodotto.

I documenti in IRIS sono protetti da copyright e tutti i diritti sono riservati, salvo diversa indicazione.

Utilizza questo identificativo per citare o creare un link a questo documento: https://hdl.handle.net/11383/1759658
Citazioni
  • ???jsp.display-item.citation.pmc??? ND
  • Scopus 8
  • ???jsp.display-item.citation.isi??? 4
social impact