Logo PTI
Polish Information Processing Society
Logo FedCSIS

Annals of Computer Science and Information Systems, Volume 11

Proceedings of the 2017 Federated Conference on Computer Science and Information Systems

Documentation Management Environment for Software Product Lines


DOI: http://dx.doi.org/10.15439/2017F106

Citation: Proceedings of the 2017 Federated Conference on Computer Science and Information Systems, M. Ganzha, L. Maciaszek, M. Paprzycki (eds). ACSIS, Vol. 11, pages 13251334 ()

Full text

Abstract. Similar documents arise in software and business situations. Examples are user guides for different versions of a software product, contracts between vendors and clients, and legal documents. The usual practice is to capture similarities in templates that must be copied and manually customized to a new context -- often a slow, tedious, and error-prone process. We propose a method based on proven approach developed for software reuse that simplifies and automates routine tasks involved in creating and updating families of similar documents. Document Management Environment (DME) provides functions to create templates and to generate custom documents from them. We identified seven types of variations typically found in similar documents. Any arbitrary document part can be designated as template's variation point, and the same inter-dependent customizations occurring at different variation points can be streamlined. We developed DME to automate generation of documentation of multiple software products (e.g., in reuse via Software Product Line approach). The paper describes two ``proof of concept'' implementations of DME as Word add-in: The first one uses Content Control mechanism and is specific to MS Word. The second one is based on ART (Adaptive Reuse Technique), a general text manipulation method and tool, and can be used to manage similar documents in any editor that provides an access to its internal textual representation of documents.


  1. Clements, P. and Northrop, L. Software Product Lines: Practices and Patterns, Addison-Wesley, 2002
  2. Jarzabek, S. Effective Software Maintenance and Evolution: Reused-based Approach, CRC Press Taylor and Francis, 2007
  3. Kang, K.C., Cohen, S.G., Hess, J.A., Novak, W.E. and Peterson, A.S., Feature-oriented domain analysis (FODA) feasibility study. Technical Report CMU/SEI-90-TR-021, SEI, Carnegie Mellon University, November 1990
  4. Koznov, D. and Romanovsky, K. “DocLine: A Method for Software Product Lines Documentation Development,” Programming and Comp. Soft., vol. 34, no. 4, pp. 216-224 (http://dx.doi.org/10.1134/S0361768808040051)
  5. Krueger, C. “The BigLever Software Gears Unified Software Product Line Engineering,” Proc. 12 th Int Soft. Product Line Conf. Limerick, 2008, p. 353
  6. Pure:systems GmbH
  7. Rabiser, R., et al “A Flexible Approach for Generating Product-Specific Documents in Product Lines,” Proc. Int. Soft. Product Line Conf, SPLC’10, Jeju, S. Korea, Sept. 2010, pp. 47-61 (http://dx.doi.org/10.1007/978-3-642-15579-6_4)
  8. XVCL, XML-based Variant Configuration Language, a reuse method and tool, http://art-processor.org