Use-perspective unit documentation

  • Frank A. Cioch
  • Fatma Mili
Part of the Lecture Notes in Computer Science book series (LNCS, volume 423)


Introductory software engineering students working on larger projects commonly encounter difficulty in group decision-making and architectural design. A use-perspective documentation framework is taught to students which is structured to overcome these two problems. Projects to which this framework is applied can be decomposed into a main unit, which requires input of the entire group, and subunits, which can be designed and coded by individual group members. A document is produced for each of the units concerning external behavior, required setup and usage of the unit. Creation of this document fosters communication and decision-making skills and requires students to engage in architectural design.


Performance Attribute Architectural Design Main Unit External Behavior Software Unit 
These keywords were added by machine and not by the authors. This process is experimental and the keywords may be updated as the learning algorithm improves.


Unable to display preview. Download preview PDF.

Unable to display preview. Download preview PDF.


  1. [1]
    Cioch, F.A. and F. Mili, "Software Documentation for Systems Integration: A Triangular Framework," Oakland University Technical Report, TR-CSE-89-10-01.Google Scholar
  2. [2]
    Cioch, F.A. and F. Mili, "Use-Oriented Documentation for Reusable Components," presented at the First Great Lakes Computer Science Conference, 1989.Google Scholar
  3. [3]
    Mili, F. and F.A. Cioch, "Documenting Decision Models for Informed and Confident Decisions," Proceedings of the 23rd Hawaii International Conference on System Sciences, IEEE, 1990.Google Scholar
  4. [4]
    Fairley, R., Software Engineering Concepts, McGraw-Hill, 1985.Google Scholar
  5. [5]
    Pressman, R.S., Software Engineering: A Practitioner's Approach, 2nd edition, McGraw-Hill, 1987.Google Scholar
  6. [6]
    Gilb, T., Principles of Software Engineering Management, Addison-Wesley, 1988.Google Scholar

Copyright information

© Springer-Verlag Berlin Heidelberg 1990

Authors and Affiliations

  • Frank A. Cioch
    • 1
  • Fatma Mili
    • 1
  1. 1.Department of Computer Science and EngineeringOakland UniversityRochester

Personalised recommendations