Here is a simple documentation strategy that emphasises minimal yet useful documentation for small to medium sized software projects. The goal is to ensure that writing the documentation is not too arduous, and that the documents are useful both during the project and after it is finished.
Traditionally, software development organisations deliver several documents, including Requirements, Functional Design and Technical Design. In this approach, each document is heavily dependent on the previous one. This means the documentation is often inconsistent. For example, if the FD needs to be revised, the TD may need updating too.
Part of this comes from the idea of forcing the customer to make all judgement calls. This can be slow. It’s better in many cases for the development team to make the call themselves, based on their understanding of customer requirements, and communicate this to the customer. The customer can then intervene if they really need to — and they won’t need to if the developers understand the actual requirements (as opposed to the documented requirements).
Here is a description of the process.
- The customer writes a Requirements document with input from the developer.
- The developer writes a Functional Specification based on the Requirements and input from the customer.
- The Requirements document is archived.
- The developer writes a Technical Design based on the Functional Specification.
- The developer writes the software based on the Functional Specification and Technical Design.
- During development, the developer updates the Technical Design and (with input from the customer) the Functional Specification.
- After development, the Functional Specification is used as a high-level reference for users and maintainers. and the Technical Design is used as a developer’s guide.
Next is a more detailed discussion of these documents.
Requirements
Requirements documentation gives a high-level view of what the project is supposed to accomplish, so can be used for time and cost estimates. Once finished, this is also used as a basis for the Functions Specification.
Requirements documentation should be written by the customer, possibly with some input from the developer. This document should be fairly short. It should not normally be updated once it has been written — once the planning has been done and the Functional Specification written and agreed, the Requirements documentation is not used any more.
Functional Specification
Functional Specification documentation shows a detailed view of what the software is supposed to do. This is its main role during development. After this, it serves as documentation for the system, useful for maintainers and even for users.
This should be detailed enough so that development could be completed based solely on the document and reasonable assumptions. But it should not include any more than this unless it is genuinely a functional requirement. For example, it should not contain implementation details — these should be in the technical documentation if anywhere. As another example, it should not normally contain detailed screen layouts, except where they really are crucial.
This documentation is normative, so it needs to be updated as requirements change during development. However, the documentation does not need to be complete, specifying everything down to the last button. This reduces the number of trivial updates to the documentation. To make this work, the developer and customer must co-operate, so the customer only pushes for changes that they really need. The developer cannot fall into the old adversarial system, saying things like “We don’t have to build that — it’s not in the spec.”
Technical Design
This is part of the software development process. As such, it should not be too detailed — low-level documentation should be included in the source code (e.g. in Javadoc documentation), where it is more useful and more likely to be kept up-to-date. Developers and maintainers use the Technical Design as a reference during development and maintenance, so it should always be kept up-to-date.
This should contain information that cannot properly go into the source code. This includes
- decisions made before coding, such as methodologies and general development and testing strategies
- specific tactics for individual modules
- coding standards
Summary
The simple documentation strategy for software projects emphasises minimal yet useful documentation for small to medium sized projects. Writing the documentation is not time-consuming, and the documents are useful both during the project and after it is finished.
hai sir iam Uday i want documentation about hotel finders please send me to my mail
sir i need documentation of any online mailing system project asap…..
i desperately need it…..
any early help would be highly appreciated….
I need the documentation on Image to html which is a based on java….please send it to my mail
i need a documentation of the project digital writer. please send it to my mail.
hello sir i need documentation for communication system using ethernet
sir i want the documentation for the project adds management using xml database wil u plz send me to my mail
i need a java project …….. plz send me in my gmail account its dream.angel922@gmail.com
sir i need documentation for the marklist generation software will you pls send to my email
sir i need documentation for the marklist generation software will you pls send to my mail
sir i need a documentation on “Pet Shop Management System” & also any related sgggestions about the software if possible.pls send me an email.
thank you
i want to create my own sacial networking community as project for final year..i want documentation and coding in php
i need documentation for the project STOCK AND BILLING MANAGEMENT
I need documentation in VB
i need document for inventory management system in VB. send to my mail-id.
sir,i need SRS documents for online travels reservation system in asp.net.pls send to my mail id
i need ducumentation for the project of newpaper management system in VB…send me as early as possible on my mail_id….
i need a java code for face recognation system pls send me on my gmail account
i need documentation for project using wireless sensor networks to support intelligent transport system.please send it to my mail.
sir i need a documentation for PROGRAMMERS EDITOR WITH SYNTAX BASED COLORING,please send me the format to my gmail account shereen.apr91@gmail.com
sir,i need a documentation for my final year project “CROSS LAYER JAMMING DETECTION AND MITIGATION IN WIRELESS BROADCAST NETWORK” please guide me to prepare the documentation and please send me the format to my mail vitchu27@gmail.com