SiteScripts
SiteScripts - PHP Scripts, CGI Scripts, Free Javascript & ASP Scripts.
Search in 6,510 resources in 345 categories
Search on SiteScripts:
Adding World-Class Documentation to Your .NET Components
Adding World-Class Documentation to Your .NET Components
I've never been a big fan of source-code-based documentation generators -- tools that attempt to produce reference documentation by mining specially- formatted comments out of source code; at least, not a big fan of any of the popular ones that have existed for C++ and Java -- and certainly not for any purpose greater than supplementing an internal spec doc. The concept is clearly of great value: by scanning the source code, the doc-generator can alert the author to any code items that are missing documentation. But historically, in this developer's opinion, they've always suffered from too many problems to be truly useful -- from buggy parsers to a wide range of usability issues, I've just never met a doc-generator that was worth the effort.
- Price: n/a
- Updated: 10/12/03
- Visits: 18