Creating developer documentation?

[Marina Levit [MVP]]

I am looking for a GUI utility that can create a CHM with documentation
and/or something that can be merged into the VS.NET help system.

NDoc for 2005 is very buggy, and there hasn't been development on it in over
half a year. The GUI gives errors at times, it can't process generics
properly, and it gets confused with certain types of tags.

Sandcastle doesn't have a GUI.

Anything else out there? Doesn't necessarily have to be free.

Thanks

 

[simon.devlin]

Hi Marina,

Sandcastle itself doesn't have a GUI, but there are wrappers for it
that GUI-it-up.

Probably the best known is
http://www.codeproject.com/useritems/SandcastleBuilder.asp, but there
are others too. In the long run I suspect that Sandcastle will be very
useful but it's definitely CTP at the moment.

Otherwise you could try http://www.doc-o-matic.com/. It's more a help
authoring system than a simple xmldoc extractor/builder but has soom
good features. The class dependency diagrams that it generates are
pretty cool
(http://www.doc-o-matic.com/images/examples/big/scclasshierarchy.png)