When you think ASP, think...
Recent Articles
All Articles
ASP.NET Articles
Message Board
Related Web Technologies
User Tips!
Coding Tips

Sample Chapters
Commonly Asked Message Board Questions
JavaScript Tutorials
MSDN Communities Hub
Official Docs
Stump the SQL Guru!
XML Info
Author an Article
ASP ASP.NET ASP FAQs Message Board Feedback
Print this page.
Document, Document, Document!

  • Back to Beginner's Tip Index
  • Next tip...

    Tip 10 stressed the importance of commenting your code. It's also important to do external documentation. Far too few developers write formal technical specifications for their ASP applications. This is needed, especially as the size of the application grows. Picking through source code, even well-documented source code, is more cumbersome than reading through a well written technical specification document. Also, keeping external documents allows those who are not code savvy to understand what your program is doing on a technical level.

    My real world experience was mixed. Some projects I've been on were well documented with both functional and technical specification documents. Others had absolutely no documentation and, not surprisingly, no foresight. The projects that fell under this latter category often were shoddy products, difficult to maintain and update.

  • Back to Beginner's Tip Index
  • Next tip...

  • ASP.NET [1.x] [2.0] | ASPFAQs.com | Advertise | Feedback | Author an Article