6 Tools for Documentation++

class designer

There's at least 6 tools we use at advantech for automating our documentation. That's a lot of tools. They are:

  1. Ghost Doc from Roland Weigelt

    for quickly adding descriptive comments to code.

  2. NDoc

    For turning XML comments into HTML. Generics not yet supported. And to get it to work with .Net 2.0 you have to jump through a flaming hoop while juggling knives between your teeth. (There's also a powertoy for VB)

  3. Class Diagram feature in Visual Studio 2005

    For reverse-engineering pretty pictures of classes. (Example at right)

  4. Visio

    For ER-Diagrams [and tracking schema changes]

  5. XDK

    Tool for building help files from inside MS Word.

  6. Copy Source As HTML

    For when code needs to be pasted as HTML. Installer for vs2005 version here, with instructions on using it.

Any favourites of yer own?

 

My book "Choose Your First Product" is available now.

It gives you 4 easy steps to find and validate a humble product idea.

Learn more.

(By the way, I read every comment and often respond.)

Your comment, please?

Your Name
Your Url (optional)
Note: I may edit, reuse or delete your comment. Don't be mean.