Delphi-PRAXiS

Delphi-PRAXiS (https://www.delphipraxis.net/forum.php)
-   Sonstige Werkzeuge (https://www.delphipraxis.net/63-sonstige-werkzeuge/)
-   -   API-Doku-Tool gesucht (für .NET und JS) (https://www.delphipraxis.net/172164-api-doku-tool-gesucht-fuer-net-und-javascript.html)

Phoenix 16. Dez 2012 21:19

API-Doku-Tool gesucht (für .NET und JS)
 
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?

vagtler 17. Dez 2012 09:14

AW: API-Doku-Tool gesucht (für .NET und JS)
 
Sagen wir mal so: wenn Du etwas gefunden hast, sag bitte sofort Bescheid. ;)

Phoenix 17. Dez 2012 17:13

AW: API-Doku-Tool gesucht (für .NET und JS)
 
Ich bin ernsthaft am überlegen, in der Richtung selber was zu bauen.
Das Problem schieben wir schon Jahre vor uns her, immer auf der Suche nach dem passenden Tool - und die "fehlende" (=nicht sauber gelieferte) Doku aus dem ganzen Xml-Doc Zeug fällt uns immer wieder auf die Füße (Leute können nicht nachlesen, bauen Umwege etc...).


Alle Zeitangaben in WEZ +1. Es ist jetzt 20:24 Uhr.

Powered by vBulletin® Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.
LinkBacks Enabled by vBSEO © 2011, Crawlability, Inc.
Delphi-PRAXiS (c) 2002 - 2023 by Daniel R. Wolf, 2024 by Thomas Breitkreuz