Dokumentation ist wichtig! Auf der TYPO3-Dev-Liste wurde erläutert, wie Extension Entwickler Feedback bzgl. der Generierung von den neuen reStructuredText Dokumentationen bekommen. Es wird inzwischen eine zusätzliche „warning.txt“ erzeugt, welche pro Extension-Version abgelegt wird, wenn die Extension eine reStructuredText-Dokumentation besitzt. Die Text-Datei kann unter folgenden URL abgerufen werden:
http://docs.typo3.org/typo3cms/extensions/EXTENSIONKAY/VERSION/warnings.txt
Zusätzlich kann die PDF Generierung in einer Extension aktiviert werden und es gibt ein Log der LaTeX Generierung. Die Log-Datei ist unter folgender URL zu erreichen:
http://docs.typo3.org/typo3cms/extensions/EXTENSIONKAY/VERSION/pdf.log
Um euch ein Beispiel zu zeigen: Dies ist die aktuelle Warning-Datei vom Autoloader 1.2.5. Aufgrund der Ausgabe, konnte der Fehler schnell korrigiert werden. Hier seht ihr zudem ein Beispiel-Log von dem LaTeX-Process. Alles sehr einfach und extrem praktisch 🙂 Auch wenn die Ausgaben an ihre Grenzen stoßen, wenn im Rendering-Prozess schwere Fehler auftreten, ist es dennoch sehr hilfreich. Danke an Francois für die Info in der Mailingliste.