Component documentation in the context of software product lines

VTT Publications

Volumn , Issue 484, 2002, Pages 3-111

  Taulavuori, Anne ^a  

^a VTT TECHNICAL RESEARCH CENTRE OF FINLAND   (Finland)

Author keywords

Component documentation; Component documentation pattern; Software engineering; Software product lines

Indexed keywords

EID: 0036966015     PISSN: 12350621     EISSN: 14550849     Source Type: Book Series    
DOI: None     Document Type: Review

References (67)

1. Arbortext. 2000. Epic Editor 4.0 and Epic Editor 4.0 LE Online help. Internal tutorial, available with Epic Editor 4.0.
2. Arbortext. 2002. Epic Editor Overview [Web document]. Available: http://www. arbortext.com/html/epic-editor-overview.html. [Referenced 25.6.2002].
3. Bachman, F., Bass, L., Buhman, C., Comella-Dorda, S., Long, F., Robert, J., Seacord, R. & Wallnau, K. 2000. Volume II: Technical Concepts of Component- Based Software Engineering. Software Engineering Institute, report CMU/SEI-2000-TR-008.
4. Bass, L., Clements, P. & Kazman, R. 1998. Software architecture in practice. Reading, Massachusetts: Addison-Wesley. 452 p. ISBN 0-201-19930-0.
5. Bertoa, M. F. & Vallecillo, A. 2002. Quality Attributes for COTS Components. 6th ECOOP Workshop on Quantitative Approaches in Object-Oriented Software Engineering, Málaga, Spain, June 2002. To be published by Springer-Verlag as a LNCS volume. 11 p.
6. Beus-Dukic, L. 2000. Non-Functional Requirements for COTS Software Components. ICSE 2000 Workshop on Continuing Collaborations for successful COTS Development, Limerick, Ireland, June 2000. Available: http://wwwsel.iit.nrc. ca/projects/cots/icse2000wkshp/positions.html. [Referenced 12.3.2002]. 5 p.
7. Biggs, W. & Evans, H. 2001. Simplify XML programming with JDOM [Web document]. Available: http://www-106.ibm.com/developerworks/library/j-jdom/. [Referenced 12.3.2002].
8. Bosch, J. 2000. Design and use of software architectures. Adopting and evolving a product-line approach. Harlow: Addison-Wesley. 354 p. ISBN: 0-201-67494-7.
9. Brownsword, L., Oberndorf, P. & Sledge, C. 2000. An Activity Framework for COTS-Based Systems. Software Engineering Institute, Technical Report CMU/SEI-2000-TR-010.
10. Clapp, J. A. & Taub, A. E. 1998. A Management Guide to Software Maintenance in COTS-Based Systems. Bedford, Massachusetts: MITRE, Center for Air Force C2 Systems. 32 p.
11. Clements, P. & Northrop, L. 2001. Software product lines. Practices and Patterns. New York: Addison-Wesley. 608 p. ISBN: 0201703327.
12. Component Registry Homepage 2002. Available: http://www. componentregistry.com/. [Referenced 26.3.2002].
13. ESA 1991. Guide to the user requirements definition phase. ESA Board for Software Standardisation and Control. ESA PSS-05-02 Issue 1. 34 p.
14. Flashline Inc. 2002. Available: http://www.flashline.com/. [Referenced 26.3.2002].
15. Forsell, M. & Päivärinta, T. 2002. A model for documenting reusable software components. In: Forsell, M. 2002. Improving Component Reuse in Software Development. Jyväskylä: Jyväskylä University Printing House. Pp. 117-150.
16. Garlan, D., Allen, R. & Ockerbloom, J. 1995. Architectural Mismatch or why it's hard to build systems out of existing parts. Proceedings of the 17th International Conference on Software Engineering, Seattle, Washington, April 1995. ACM Press, New York, USA. Pp. 179-185.
17. Harold, E. 1999. XML Bible. Foster City, USA: IDG Books WorldWide, Inc. 1015 p. ISBN: 0-7645-3236-7.
18. Harold, E. 2001. Processing XML with Java [Web document]. To be published by Addison-Wesley in November 2002. Available: http://www.ibiblio.org/xml/ books/xmljava/. [Referenced 25.4.2002].
19. Heineman, G. T. & Councill, W. T. 2001. Component-Based Software Engineering. Putting the Pieces Together. New York: Addison-Wesley. 817 p. ISBN: 0-201-70485-4.
20. IEE. 1986. Guidelines for the documentation of software in industrial computer systems. London: The Institution of Electrical Engineers. ISBN: 086341 046 4.
21. IEEE Std 1062-1993. 1993. IEEE Recommended Practice for Software Acquisition. The IEEE Computer Society, Brussels, Belgium.
22. IEEE Std 610.12-1990. 1990. IEEE Standard Glossary of Software Engineering Terminology. The Institute of Electrical and Electronics Engineers, Inc., New York, USA.
23. iLogix. 2002. Rhapsody in C++ [Web document]. Available: http://www.ilogix.com/. [Referenced 18.2.2002].
24. Iribarne, L., Vallecillo, A., Alves, C. & Castro, C. 2001a. A Non-functional Approach for COTS Components Trading. Proceedings of the 4th Workshop on Requirements Engineering, Buenos Aires, Argentina, November 2001. Tercer Milenio, Buenos Aires, 2001. Pp. 124-138.
25. Iribarne, L., Troya, J. M. & Vallecillo, A. 2001b. Trading for COTS components in Open Environments. Proceedings of the 27th Euromicro Conference on Component-Based Software Engineering, Warsaw, Poland, September 2001. IEEE Computer Society Press. Pp. 22-29.
26. Iribarne, L., Vallecillo, A. & Troya, J. M. 2002. COTStrader. The trading process of COTS components [Web document]. Available: http://www.cotstrader.com/. [Referenced 25.3.2002].
27. ISO/IEC-9126. 1991. Information technology - Software product evaluation -Quality characteristics and guidelines for their use. International Standard ISO/IEC 9126, International Standard Organization, Geneve.
28. Jacobson, I., Booch, G. & Rumbaugh, J. 1998. The Unified Software Development Process. New York: Addison-Wesley. 463 p. ISBN: 0-201-57169-2.
29. JDOM Homepage. 2002. Available: http://www.jdom.org/. [Referenced 27.3.2002].
30. Kallio, P. & Niemelä, E. 2001. Documented Quality of COTS and OCM Components. Proceedings of the 4th ICSE Workshop on Component-Based Software Engineering: Component Certification and System Prediction, Toronto, Canada, May 2001. IEEE Computer Society, USA. Pp. 111-114.
31. Karlsson, E.-A. 1996. Software reuse - a holistic approach. Chichester: John Wiley & Sons. 510 p.
32. Kay, M. 2001. Anatomy of XSLT processor [Web document]. Available: http://www-106.ibm.com/developerworks/library/x-xslt2/. [Referenced 3.9.2001].
33. Kontio, J. 1996. A Case Study in Applying a Systematic Method for COTS Selection. Proceedings of the 18th International Conference on Software Engineering, Berlin, Germany, March 1996. IEEE Computer Society Press, Los Alamitos, CA, USA. Pp. 201-209.
34. Kunda, D. & Brooks, L. 1999. Applying social-technical approach for COTS selection. Proceedings of 4th UKAIS Conference, University of York, April 1999. In: Brooks L., Kimble, C. 1999. Information Systems - The Next Generation. McGraw Hill. Pp. 552-565. ISBN 0 07 709558 8.
35. Matinlassi, M., Niemelä, E. & Dobrica, L. 2002. Quality-Driven Architecture Design and Quality Analysis Method. A revolutionary initiation approach to a product line architecture. Espoo: Technical Research Centre of Finland. VTT Publications 456. 128 p. + app. 10 p.
36. McClure, C. 1994. Reuse Engineering: Extending Information Engineering to Enable Software Reuse [Web document]. Extended Intelligence, Inc. Available: http://www.reusability.com/papers4.html. [Referenced 12.8.2002].
37. Meyers, B. C. & Oberndorf, P. 2001. Managing Software Acquisition: Open Systems and COTS Products. New York: Addison-Wesley. 360 p. ISBN: 0-201-70454-4.
38. Microsoft. 2002a. COM Interfaces [Web document]. Available: http://www.microsoft com/technet/treeview/default.asp?url=/TechNet/prodtechnol /host/proddocs/hisdoc/appint/ comti-com-interfaces.asp. [Referenced 15.4.2002].
39. Microsoft. 2002b. MSXML parser 3.0 [Web document]. Available: http://msdn. microsoft.com/downloads/. [Referenced 13.8.2001].
40. Morisio, M. & Sunderhaft, N. 2000. Commercial-Off-The-Shelf (COTS): A Survey. A DACS State-of-the-Art Report Contract Number SP0700-98-D-4000, Data Analysis Center for Software, Rome, NY. 95 p.
41. Ncube, C. & Maiden, N. 2000. COTS Software Selection: The Need to make Tradeoffs between System Requirements, Architectures and COTS/Components. ICSE 2000 Workshop on Continuing Collaborations for successful COTS Development, Limerick, Ireland, June 2000. Available: http://wwwsel.iit.nrc.ca/projects/ cots/ icse2000wkshp/positions.html. [Referenced 15.4.2002]. 9 p.
42. Niemelä, E. 1999. A component framework of a distributed control systems family. Espoo: Technical Research Centre of Finland. VTT Publications 402. 188 p. + app. 68 p.
43. Niemelä, E., Kuikka, S., Vilkuna, K., Lampola, M., Ahonen, J., Forssel, M., Korhonen, R., Seppänen, V. & Ventä, O. 2000. Tekes-raportti: Teolliset komponentti- ohjelmistot. Kehittämistarpeet ja toimenpide-ehdotukset. Teknologiakatsaus 89/2000.
44. Niemelä, E., Taulavuori, A. & Kallio, P. 2002. Component Documentation - a Key Issue in Software Product Lines. Submitted to Journal of Systems and Software. 24 p.
45. Northrop, L. 2002. A Framework for Software Product Line Practice. Version 3.0. [Web-document]. Software Engineering Institute, Carnegie Mellon University, Pittsburgh. Available: http://www.sei.cmu.edu/plp/framework.html. [Referenced 22.1.2002].
46. NPLACE. 2002. The National Product Line Asset Center, NPLACE. Available: http://www.nplace.wvhtf.org/. [Referenced 22.5.2002].
47. Object Management Group. 2002. XML Metadata Interchange (XMI) [Web document]. Available: http://xml.coverpages.org/xmi.html. [Referenced 13.3.2002].
48. Ogush, M., Coleman, D. & Beringer, D. 2000. A template for documenting software and firmware architectures [Web-document]. Hewlett-Packard. Available: http://www.architecture.external.hp.com/index.htm. [Referenced 26.9.2002].
49. Open Source Initiative. 2002. The Open Source Definition, version 1.9 [Web document]. Available at: http://www.opensource.org/docs/definition.html. [Referenced 22.5.2002].
50. Park, R. 1992. Software Size Measurement: A Framework for Counting Source Statements, CMU/SEI-92-TR-20, Software Engineering Institute, Pittsburgh, PA.
51. Pressman, R. 1997. Software engineering. A practitioner's approach, 4th edition. New York: McGraw-Hill. 885 p. ISBN: 0 07 709 411 5.
52. Sametinger, J. 1997. Software engineering with reusable components. New York: Springer Verlag. 272 p. ISBN: 3-540-62695-6.
53. Seppänen, V., Helander, N., Niemelä, E. & Komi-Sirviö, S. 2001. Towards original software component manufacturing. Espoo: VTT. VTT Research Notes 2095. 105 p.
54. SER Consortium. 1996. Solutions for Software Evolution and Reuse III [Web document]. SER Esprit Project 9809. Available: http://dis.sema.es/projects/ SER/solutions/solutions3.html. [Referenced 4.4.2002].
55. Sommerville, I. 1992. Software engineering, 4th edition. Workingham: Addison- Wesley. 649 p. ISBN: 0-201-56529-3.
56. Svahnberg, M. & Bosch, J. 2000. Issues Concerning Variability in Software Product Lines. Proceedings of the Third International Workshop on Software Architectures for Product Families, Gran Canaria, Spain, March 2000. Heidelberg, Germany: Springer LNCS. Pp. 146-157.
57. Taulavuori, A., Kallio, P. & Niemelä, E. 2002. Documentation system of commercial components. Accepted to the 15th International Conference on Software & Systems Engineering, ICSSEA 2002, Paris, December 2002. 9 p.
58. Vidger, M. & Dean, J. 1997. An Architectural Approach to Building Systems from COTS Software Components. Proceedings of the 22nd Annual Software Engineering Workshop, Greenbelt, Maryland, December 1997. Technical Report 40221, National Research Council.
59. Vigder, M. 1998. An Architecture for COTS Based Software Systems. NRC Report No. 41603. Canada: National Research Council of Canada. 22 p.
60. Wallace, D. R., Peng, W. W. & Ippolito, L. M. 1992. Software Quality Assurance: Documentation and Reviews [Web document]. NIST IR 4909. Available: http://hissa.ncsl.nist.gov/publications/nistir4909/. [Referenced 17.6.2002].
61. Walsh, N. 1998. A Technical Introduction to XML. InterCHANGE, Vol. 4, Issue 2. Pp. 17-26.
62. World Wide Web Consortium. 2001a. Extensible Markup Language (XML) [Web document]. Available: http://www.w3.org/XML. [Referenced 28.8.2001].
63. World Wide Web Consortium. 2001b. XML Schema [Web document]. Available: http://www.w3.org/XML/Schema. [Referenced 28.8.2001].
64. World Wide Web Consortium. 2002a. Document Object Model (DOM) [Web document]. Available: http://www.w3c.org/DOM. [Referenced 15.2.2002].
65. World Wide Web Consortium. 2002b. The Extensible Stylesheet Language [Web document]. Available: http://www.w3c.org/Style/XSL. [Referenced 28.8.2001].
66. Yacoub, S., Mili, A., Kaveri, C. & Dehlin, M. 2000. A Hierarchy of COTS Certification Criteria. Proceedings of the First Software Product Line Conference, SPLC1, Denver, Colorado, August 2000. Kluwer Academic Publishers, Boston. Pp. 397-412.
67. Yakimovich, D., Bieman, J. M. & Basili, V. R. 1999. Software architecture classification for estimating the cost of COTS integration. Proceedings of the 21st International Conference on Software Engineering, Los Angeles, USA, May 1999. IEEE Computer Society Press, Los Alamitos, CA, USA. Pp. 296-302.