Moinsen,
liegt es an mir oder ist http://api.contao.org/ aktuell nicht erreichbar?
Ist schon seit letzte Woche down.
Wann wird die API-Doku wieder verfügbar sein oder ist die Domain abgeschaltet?
Danke für Infos.
Druckbare Version
Moinsen,
liegt es an mir oder ist http://api.contao.org/ aktuell nicht erreichbar?
Ist schon seit letzte Woche down.
Wann wird die API-Doku wieder verfügbar sein oder ist die Domain abgeschaltet?
Danke für Infos.
https://contao.org/de/news/bereinigu...essourcen.html
Zitat:
api.contao.org
Unter der Domain api.contao.org befindet sich ein Export der phpDoc-Kommentare, mit denen der Contao-Code inline dokumentiert wird. Diese Dokumentation ist jedoch primär für die Verwendung in PHP-IDEs gedacht, so dass die Online-Version kaum genutzt wird und deshalb zum Jahresende entfällt.
Hey ho,
danke für die Info.
Schade, ich habe da immer gern nachgeschaut.
Gibt es Ersatz (außer den Inline-Kommentaren)?
Wenn du sie wirklich haben willst, dann lass den phpDocumentor doch selber eben dryber laufen, dann hast du sie wieder. :)
Danke für eure Hinweise...
... warum kann das nicht auch auch einer Webseite findbar sein? dürfte doch per Cronjob kein Akt sein die Doku 1x tgl. neu zu generieren...
... höchstwahrscheinlich weil alle, die damit richtig Arbeiten dies über eine anständige IDE erledigen ;-) ... und keine zusätzliche Online-Version benötigen.
eines der Kriterien bei einem Framework o.ä. ist die Qualität der Dokumentation - wenn ich dies hier https://docs.contao.org/books/api/index.html als "Contao-Unwissender" aufrufen würde, gäbe es wahrscheinlich nur 2 von 10 Punkten...
Was hat denn jetzt die Dokumentation mit der API (um die es hier ursprünglich ging) zu tun?
Die Dokumentation war schon IMMER Aufgabe der Community (im Wiki). Diese kann nicht automatisiert erstellt werden, sondern jeder in der Community ist aufgefordert diese Dokumentation zu erweitern/verbessern.
Unter api.contao.org war früher lediglich der Aufbau des Frameworks hinterlegt. Also alle Klassen, Methoden und wie sie zueinander stehen. Und das fällt halt nun weg, deswegen bleibt die "Doku" wie bisher im Wiki erhalten.
Dein Link zu https://docs.contao.org/books/api/index.html hatte schon immer diesen Umfang, da dieser Inhalt früher lediglich auf der contao.org Webseite manuell gepflegt wurde, nun zu Github umgezogen ist, um eine bessere Bearbeitung möglich zu machen. Doch auch diese "API Reference" hat nichts mit der ursprünglichen api.contao.org zu tun.
Schaut doch einfach bei Github in den Quelltext. Ab und an mache ich das auch.