Component documentation - A key issue in software product lines

Information and Software Technology

Volumn 46, Issue 8, 2004, Pages 535-546

  Taulavuori, Anne ^a   Niemelä, Eila ^a   Kallio, Päivi ^a  

^a Embedded Software   (Finland)

Author keywords

Component documentation; Software product line; Third party component

Indexed keywords

COMPUTER ARCHITECTURE; DATABASE SYSTEMS; GRAPHICAL USER INTERFACES; MIDDLEWARE; NETWORK PROTOCOLS; PROGRAM DOCUMENTATION; QUALITY CONTROL; SOFTWARE ENGINEERING;

COMPONENT DOCUMENTATION; THIRD-PARTY COMPONENTS;

COMPUTER SOFTWARE;

EID: 1842607329     PISSN: 09505849     EISSN: None     Source Type: Journal    
DOI: 10.1016/j.infsof.2003.10.004     Document Type: Article

References (35)

1. American Nuclear Society, American National Standard for Documentation of Computer Software, ANSI/ANS-10-3-1995, American Nuclear Society, Illinois, USA, 1995.
2. Bass L., Clements P., Kazman R. Software Architecture in Practice. 1998;Addison-Wesley, Reading, MA. p. 452.
3. Bosch J. Design and Use of Software Architectures. Adopting and Evolving a Product Line Approach. 2000;Addison-Wesley, Harlow. p. 354.
4. Clements P., Northrop L. Software Product Lines, Practices and Patterns. 2001;Addison-Wesley, New York. 608 p.
5. ESA, Guide to the user requirements definition phase, ESA Board for Software Standardisation and Control (BSSC), ESA PSS-05-03 Issue 1, Revision 1, 1995, 52 p.
6. Forsell M., Päivärinta T. A model for documenting reusable software components. Forsell M. Improving Component Reuse in Software Development. 2002;117-150 Jyväskylä University Printing House, Jyväskylä, Finland.
7. Heineman G.T., Councill W.T. Component-Based Software Engineering. Putting the Pieces Together. 2001;Addison-Wesley, New York. 817 p.
8. A. van Hoff, H. Partovi, T. Thai, The Open Software Description Format (OSD), Acknowledged Submissions to W3C, 1997. (Available at: http://www.w3.org/TR/NOTE-OSD [12.9.2003]).
9. Guidelines for the Documentation of Software in Industrial Computer Systems. 1985;The Institution of Electrical Engineers, London. ISBN: 086341 046 4, 75 p.
10. IEEE Standard for Software User Documentation. IEEE Std 1063-1987. 1988;The Institution of Electrical and Electronics Engineers Inc. New York. 16 p.
11. IEEE Standard Glossary of Software Engineering Terminology. IEEE Std 610.12-1990. 1990;The Institute of Electrical and Electronics Engineers, Inc. New York.
12. IEEE Guide to Software Design Descriptions. IEEE Std 1016.1-1993. 1993;The Institution of Electrical and Electronics Engineers Inc. New York. 28 p.
13. IEEE Standard for Software Test Documentation. IEEE Std 829-1998. 1998;The Institution of Electrical and Electronics Engineers Inc. New York. 59 p.
14. IEEE Standard for Software Quality Assurance Plans. IEEE Std 730-2002. 2002;The Institution of Electrical and Electronics Engineers Inc. New York. 17 p.
15. Iribarne L., Troya J.M., Vallecillo A. Trading for COTS components in open environments. Proceedings of the 27th Euromicro Conference on Component-Based Software Engineering, Warsaw, Poland, September 2001. 2001;IEEE Computer Society Press.
16. ISO/IEC-9126, Information technology - Software product evaluation - Quality characteristics and guidelines for their use, International Standard ISO/IEC 9126, International Standard Organization, Geneva, 1991.
17. P. Kallio, E. Niemelä, Documented Quality of COTS and OCM components, Fourth ICSE Workshop on Component-Based Software Engineering: Component Certification and System Prediction, Toronto, Canada, 2001, pp. 111-114.
18. Karlsson E.-A. Software Reuse - a Holistic Approach. 1996;Wiley, Chichester. 510 p.
19. Matinlassi M., Niemelä E., Dobrica L. Quality-Driven Architecture Design and Quality Analysis Method. A Revolutionary Initiation Approach of a Product Line Architecture. 2002;Technical Research Centre of Finland, VTT Publications 456, Espoo. 128 p., +app 10 p.
20. Meyers B.C., Oberndorf P. Managing Software Acquisition: Open Systems and COTS Products. 2001;Addison-Wesley, New York. 360 p.
21. Niemelä E., Kuikka S., Vilkuna K., Ahonen J., Lampola M., Forsell M., Korhonen R., Seppänen V., Ventä O. Industrial Software Components. Development Concerns and Strategic Initiatives. Technology Survey 89/2000. 2000;Technology Development Center Tekes, Helsinki. 129 p., in Finnish, abstract in English.
22. Northrop L. A Framework for Software Product Line Practice. Version 3.0. [Web-document]. 2002;Software Engineering Institute, Carnegie Mellon University, Pittsburgh. Available at: http://www.sei.cmu.edu/plp/framework.html.
23. NPLACE, The National Product Line Asset Center, NPLACE, 2002. (Available at: http://www.nplace.wvhtf.org/ ).
24. M. Ogush, D. Coleman, D. Beringer, A template for documenting software and firmware architectures, Hewlett-Packard, 2000. (Available at: http://www.architecture.external.hp.com/Download/arch_template_ vers13_withexamples.pdf ).
25. Open Source Initiative, The Open Source Definition, version 1.9 [Web document], 2003. (Available at: http://www.opensource.org/docs/definition.html ).
26. Purhonen A., Niemelä E., Matinlassi M. Viewpoints of DSP Software and Service Architectures. Journal of Systems and Software. 169:(1-2):2004;57- 73.
27. M. Salmela, J. Korhonen, J. Kalaoja, Automated test reuse for product families, Software Quality Week Europe, QWE '99, Brussels, BE, Software Research Institute, 1999. 13 p.
28. Sametinger J. Software Engineering with Reusable Components. 1997;Springer, New York. 272 p.
29. Sommerville I. Software Engineering. fourth ed. 1992;Addison-Wesley, Workingham. 649 p., ISBN: 0-201-56529-3.
30. Seppänen V., Helander N., Niemelä E., Komi-Sirviö S. Towards original software component manufacturing. VTT Research Notes 2095. 2001;Technical Research Centre of Finland, Espoo. 105 p.
31. SER Consortium, Solutions for Software Evolution and Reuse III [Web document], SER Esprit Project 9809, 1996. (Available at: http://dis.sema.es/ projects/SER/solutions/solutions3.html ).
32. Taulavuori A. Component Documentation in the Context of Software Product Lines. VTT Publications 484. 2002;VTT Electronics, Espoo. 111 p., +app. 3 p.
33. Taulavuori A., Kallio P., Niemelä E. Documentation system of commercial components. Proceedings of the 15th International Conference on Software and Systems Engineering and their Applications, ICSSEA, Paris, France. vol. 2:2002;CNAM, Paris. 9 p.
34. Voas J.M. The challenges of using COTS software in component-based development. Computer. June:1998.
35. D. Wallace, W. Peng, L. Ippolito, Software Quality Assurance: Documentation and Reviews, NISTIR 4909, 1999. (Available at: http://hissa.ncsl.nist.gov/publications/nistir4909/.).