All geek questions in one place

Sandcastle or NDoc? Good msdn-like doc generator?

I always bothered myself with the question: "Javadoc, Doxygen and much more .. is it really possible that Microsoft does not provide its developers with a good dock-code generator?". It was always strange to me ... Also because Msdn is a very good set of documents for documentation ... I really prefer it above all other generators and documentation styles.

Continuing to worry, I finally decided to delve deeper into this problem and discovered the existence of NDoc and SandCastle. Wow, I told myself, I finally understood ... It seemed so. Well, they are good generators, but I thought that Microsoft sponsored the official doc gen a bit more than the ones I mentioned before.

So what do I need? Just knowing which doc-gen a Microsoft developer uses to document his msdn-style code. Is the official MSDn-like NDoc or Sand Castle document generator approved by my Microsoft? Which one is better? If not, which doc-gen should be used for msdn-style documentation?

+3
source share
3 answers

SandCastle (with a graphical interface) is a fully adequate documentation generator. I don’t see the reason MS is putting more effort into it.

, GhostDoc Visual Studio. ( , ).

+1

DocumentX ( NDoc), . - , .

+2

Despite the fact that the initial NDoc project was stopped several years ago, there is a successor project: NDoc3

+1
source

Source: https://habr.com/ru/post/1781063/

More articles:


All Articles