Documentation Guidelines
Document major design decisions
Write the pros and cons of the design decisions and why the decision was made in the described way.
If you are involved in a field trip, document your findings, using the following format.
Cross-reference your documentations
Write out comments whenever you write code.