Sample Content for Documents
If the project
you are carrying out is a software engineering project, you will find below
suggestions about the content of the key documents. These suggestions are just
given as an example and not binding by any means, but of course, your advisor
will provide you with more guidance and suggestions more adequate and more
appropriate for the needs of your specific senior project.
A sample
conception document content as suggested by Boehm in his article” Anchoring the
Software Process” is as follows:
- Motivation
- Background
- Business Case
- User Scenario(s)
- Evaluation Criteria
A sample
elaboration document content
--after the first phase-- as suggested by Boehm in his article” Anchoring
the Software Process” is as follows:
- Development timeline (plan)
- Project Risks
- Use Cases
- Conceptual Model
- List of Requirements (functional and non-functional)
- System Sequence Diagram/Flow Charts
- Architectural Design/Circuit Diagram/Hardware Block Design
- Design Rationale
- Technologies Used
- Component State
Chart(s)
- Test Plan, including test cases
- User Manual
- Test or Experimental Results
A sample
elaboration final document content would be the revised section from previous
document plus
- System Prototype
- Collaboration Diagrams
- Class Diagram or Schematic
- Risk Resolution/mitigation
Sample
construction final document content would be as follows:
- Source code or completed implementation;
- Build and install scripts, and/or instructions for
installing/deploying hardware;
- Deployment instruction;
- Test cases, including input, expected output, and test
implementation;
- Test results for features implemented
Sample delivery
document content would be structured as follows:
- User Manual
- API Documentation
- Maintenance Guide
- Suggested Changes
- Experiences/Lessons learned
- Complete Test results