Towards an Ontology-based Software Documentation Management - A Case Study

Anna Goy, Diego Magro

2012

Abstract

One of the main issues that a company has to face is the generation and maintenance of product documentation. In particular, several software houses have to take into account the frequent need of rapidly updating software applications, and the corresponding technical documentation, as a consequence of changes in the administrative rules and laws. In order to support documentation generation and maintenance processes, we performed an ontological analysis of these processes in a large Italian software house that produces and sells enterprise applications for small-to-medium sized enterprises. The goal of such a domain analysis was to build a conceptual model enabling a formal characterization of the main elements involved in software documentation. Such a formalization represents the “competence” of a system supporting documentation processes, since it enables it to answer competency questions representing the information needs of the documentation writers (e.g., “In which technical sheets/application manuals/operating manuals is used a given concept?”; “Which technical sheets belonging to a given operating manual do mention a given functionality/screenful/form field?”; “Which are the functionalities/screenfuls/technical sheets potentially impacted by the change of a given software module/file?”).

References

  1. Ambrósio, A.P., Santos, D.C.d., Lucena, F.N.d., Silva, J.C.d. (2004). Software Engineering Documentation: an Ontology-based Approach. WebMedia & LAWeb Joint Conference. Washington: IEEE Press, 38-40.
  2. Gangemi, A., Borgo, S., Catenacci, C., Lehmann, J. (2005). Task Taxonomies for Knowledge Content. Metokis, Deliverable D07.
  3. Hepp, M. and Wechselberger, A. (2008). OntoNaviERP: Ontology-Supported Navigation in ERP Software Documentation. International Semantic Web Conference - ISWC2008, LNCS 5318. Heidelberg: Springer, 764-776.
  4. Kleiber, W., Sabol, V., Kern, R., Muhr, M., Granitzer, M. (2009). Using Ontologies For Software Documentation. Malaysian Joint Conference on Artificial Intelligence - MJCAI2009. Kuala Lumpur, Malaysia.
  5. Magro, D., Goy A. (2012). A core reference ontology for the customer relationship domain. Applied Ontology, 7(1), 1-48.
  6. Oberle, D. (2006). Semantic Management of Middleware. Heidelberg: Springer.
  7. Oberle, D., Lamparter, S., Grimm, S., Vrandecic, D., Staab, S., Gangemi, A. (2006). Towards Ontologies for Formalizing Modularization and Communication in Large Software Systems. Applied Ontology, 1(2), 163-202.
  8. Sabou, M. (2004). Extracting Ontologies from Software Documentation: a Semi-Automatic Method and its Evaluation. In Workshop on Ontology Learning and Population at ECAI 2004, Valencia, Spain.
  9. Studer, R., Benjamins, V. R., Fensel D. (1998). Knowledge Engineering: Principles and Methods. Data and Knowledge Engineering, 25(1-2), 161-197 .
  10. Witte, R., Zhang, Y., Rilling, J. (2007). Empowering Software Maintainers with Semantic Web Technologies. European Semantic Web Conference - ESWC2007, LNCS 4519. Heidelberg. Springer, 37-52.
Download


Paper Citation


in Harvard Style

Goy A. and Magro D. (2012). Towards an Ontology-based Software Documentation Management - A Case Study . In Proceedings of the International Conference on Knowledge Management and Information Sharing - Volume 1: KMIS, (IC3K 2012) ISBN 978-989-8565-31-0, pages 125-131. DOI: 10.5220/0004124001250131


in Bibtex Style

@conference{kmis12,
author={Anna Goy and Diego Magro},
title={Towards an Ontology-based Software Documentation Management - A Case Study},
booktitle={Proceedings of the International Conference on Knowledge Management and Information Sharing - Volume 1: KMIS, (IC3K 2012)},
year={2012},
pages={125-131},
publisher={SciTePress},
organization={INSTICC},
doi={10.5220/0004124001250131},
isbn={978-989-8565-31-0},
}


in EndNote Style

TY - CONF
JO - Proceedings of the International Conference on Knowledge Management and Information Sharing - Volume 1: KMIS, (IC3K 2012)
TI - Towards an Ontology-based Software Documentation Management - A Case Study
SN - 978-989-8565-31-0
AU - Goy A.
AU - Magro D.
PY - 2012
SP - 125
EP - 131
DO - 10.5220/0004124001250131