Software Documentation
The process of developing software is a long and waiting procedure. Some times it become complicated when we don't have any record about the procedures we adopted to build software, made no paper work and no
diagramed work. There will be no help when we want to test, update and make any changes.
We need complete documentation of our software to avoid these complications and a complete
documentation can be made by following the all phases of process model we choose.
what should be documented?
. The requirement specification should be completely documented because the
programmer will have to follow them. He and the customer have not much time to spare on meetings. The documented requirement specification is also helpful during finalizing the agreement of software in between customer and the developer.
.The documentation of analysis phase is also have great importance. All the measurements, calculations, initial costs, time period calculation and affecting factors are calculated in this phase. So it is necessary to keep your all analysis in record.
.Initially the proposed system or the software we are going to build have to be designed. So how much critical is it to keep the permanent documentation of the design of the software. It will not only help us in first time building the proposed system but also helpful for future changes.
.The code of the software is very secrete and precious for the developers, so it is always kept in form of backup and documents.
.Testing reports are very much helpful to rate the quality of the software and also
helpful to invest further more in the project in the future. In other words, it define your whole system on few papers.
Template for documentation of each phases
.Requirement Specification & Anlysis
Project Name:
|
Address:
|
Existing system's case study:
|
Questionnaire
|
Maximum W questions:
|
Maximum R questions:
|
Maximum S questions:
|
System's boundary:
|
Initial time period & cost:
|
Hardware:
|
Operating system:
|
Comments:
|
|
|
.Design
Preliminary Design
|
Multi step process:
|
Data structures:
|
Software architecture:
|
Procedural detail:
|
Detailed Design
|
Program partition
|
Module logic:
|
Module techniques:
|
Diagramed approach:
|
File format for I/O:
|
Tools:
|
Interface:
|
Security & authentication:
|
Comments:
|
|
|
.Coding
Backend
|
Code of procedures:
|
Code of modules:
|
Code of stubs:
|
Code Of system:
|
Interface
|
Form's code:
|
Components on form:
|
Security & authentication files:
|
Dll files:
|
Active X controls:
|
Comments:
|
|
|
.Testing
.Unit Testing
|
Project name:
|
Schedule/Date:
|
Test items:
|
Features tested:
|
Features not tested:
|
Pass fail criteria:
|
Comments:
|
.System Level Test
|
Introduction:
|
Test items:
|
Features tested:
|
Features not tested:
|
Approach:
|
Item pass fail criteria:
|
Suspension criteria & resumption requirements:
|
Comments:
|
|
|
|
|
|