• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Stop wasting time looking for files and revisions. Connect your Gmail, DriveDropbox, and Slack accounts and in less than 2 minutes, Dokkio will automatically organize all your file attachments. Learn more and claim your free account.

View
 

How much documentation should be written

Page history last edited by Venu Tadepalli 11 years, 4 months ago

How much documentation should be written?

 

 

Remember documentation is just one medium of communication and not the product itself. i.e. it is merely a means to the end and not the end in itself.

 

That said there is no denying that we will need to produce various documents throughout the project in order to communicate. Make sure that each document that is created goes through the sanity check of

  1. -          Is this the best medium of communication?
  2. -          Can this be maintained?
  3. -          What is the cost vs. benefit of creating the document?

Once you agreed on the need to document, please remember, Microsoft Word is not the only medium of documentation. Evaluate all possible alternatives

  1. -          Models
  2. -          Add to code comments and generate documentation using tools like Ndoc
  3. -          Create executable test, or manual test cases

 

Further reading:

http://www.agilemodeling.com/essays/agileDocumentation.htm

Comments (0)

You don't have permission to comment on this page.