Hi,
ich suche ein Tool um .NET- und JavaScript-Code möglichst automatisiert in eine
API-Dokumentation zu packen.
Ziel wäre eine Web-Doku im Stil der (aktuellen)
MSDN-Dokumentation.
Zudem haben wir mehrere Frameworks zu dokumentieren, die jedoch zu Teilen aufeinander aufbauen. Es muss daher möglich sein, innerhalb der Dokumentation eines Projektes auf eine verwendete Basisklasse eines anderen Projektes zu verlinken.
Microsoft selber nutzt aktuell noch
Sandcastle für ihre
MSDN 2012, hat das Sandcastle-Projekt aber nun komplett an die Community abgegeben, weil sie ein neues internes Tool entwickeln. Sandcastle ist sehr komplex und langsam, und wenn Microsoft schon eine Alternative entwickelt möchte ich nicht ab dem Zeitpunkt an dem es von denen verworfen wird darauf setzen.
Ich kenne noch Doc-O-Matic, aber hier fehlt die Verlinkungsoption, und zudem der
MSDN 2012 Style.
DocumentX! von Innovasys kann kein Vanilla JavaScript (nur asp.net ajax code), und ist relativ teuer. Zudem setzt es intern auf Sandcastle auf und ist entsprechend langsam. Die Verlinkungsoption ist nur mit derben eingriffen in das Tool zu erreichen.
Doxygen kann gar kein JavaScript. Die anderen Punkte habe ich mir hier noch nicht angesehen.
Kennt jemand noch ein Tool das die oben genannten Punkte abdeckt?