AGB  ·  Datenschutz  ·  Impressum  







Anmelden
Nützliche Links
Registrieren
Zurück Delphi-PRAXiS Sprachen und Entwicklungsumgebungen Sonstige Werkzeuge API-Doku-Tool gesucht (für .NET und JS)
Thema durchsuchen
Ansicht
Themen-Optionen

API-Doku-Tool gesucht (für .NET und JS)

Ein Thema von Phoenix · begonnen am 16. Dez 2012 · letzter Beitrag vom 17. Dez 2012
Antwort Antwort
Benutzerbild von Phoenix
Phoenix
(Moderator)

Registriert seit: 25. Jun 2002
Ort: Hausach
7.641 Beiträge
 
#1

API-Doku-Tool gesucht (für .NET und JS)

  Alt 16. Dez 2012, 22:19
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?
Sebastian Gingter
Phoenix - 不死鳥, Microsoft MVP, Rettungshundeführer
Über mich: Sebastian Gingter @ Thinktecture Mein Blog: https://gingter.org
  Mit Zitat antworten Zitat
vagtler

Registriert seit: 9. Jul 2010
Ort: Köln
667 Beiträge
 
Delphi 2010 Professional
 
#2

AW: API-Doku-Tool gesucht (für .NET und JS)

  Alt 17. Dez 2012, 10:14
Sagen wir mal so: wenn Du etwas gefunden hast, sag bitte sofort Bescheid.
  Mit Zitat antworten Zitat
Benutzerbild von Phoenix
Phoenix
(Moderator)

Registriert seit: 25. Jun 2002
Ort: Hausach
7.641 Beiträge
 
#3

AW: API-Doku-Tool gesucht (für .NET und JS)

  Alt 17. Dez 2012, 18:13
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...).
Sebastian Gingter
Phoenix - 不死鳥, Microsoft MVP, Rettungshundeführer
Über mich: Sebastian Gingter @ Thinktecture Mein Blog: https://gingter.org
  Mit Zitat antworten Zitat
Antwort Antwort


Forumregeln

Es ist dir nicht erlaubt, neue Themen zu verfassen.
Es ist dir nicht erlaubt, auf Beiträge zu antworten.
Es ist dir nicht erlaubt, Anhänge hochzuladen.
Es ist dir nicht erlaubt, deine Beiträge zu bearbeiten.

BB-Code ist an.
Smileys sind an.
[IMG] Code ist an.
HTML-Code ist aus.
Trackbacks are an
Pingbacks are an
Refbacks are aus

Gehe zu:

Impressum · AGB · Datenschutz · Nach oben
Alle Zeitangaben in WEZ +1. Es ist jetzt 23:43 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