Moin zusammen,
ich wollte gerne nochmal nachfragen, wie es um die Contao-Dokumentation steht und erneut meine Unterstützung anbieten. Über die Dokumentation wurde ja schon bei mehreren Veranstaltungen und hier im Forum gesprochen. Auch hat sich ja im letzten Jahr die Idee konkretisiert und es sah so aus, als würde etwas passieren. Allerdings kann ich nach wie vor nicht wirklich einen Fortschritt erkennen, weiß aber nicht, ob es daran liegt, dass ich nicht weiß, wo ich schauen muss, oder ob wirklich nichts passiert ist. Auf docs.contao.org jedenfalls ist vieles eher veraltet und/oder unvollständig.
Mir ist klar, dass man in die Dokumentation viel Arbeit investieren muss. Ich möchte meinen Post deshalb nicht als Kritik verstanden wissen, sondern wie gesagt gerne erneut meine Mithilfe anbieten, weiß aber nicht, an wen ich mich wenden muss und wie ich mithelfen kann. Ich denke/hoffe, dass es anderen ähnlich geht.
Deshalb hier mal ein paar Fragen:
- Wie ist der Stand der Dinge?
- Wo kann ich den Stand sehen?
- Wer ist verantwortlich (und wen kann ich fragen)?
- Wie kann ich dazu beitragen?
- UND: Wer hat sonst noch Interesse, zur Dokumentation beizutragen und ist bereit, ein paar Stunden zu investieren?
Für mich ist das Thema gerade wieder aktuell, weil es mit Contao 4.8 Änderungen und neue Funktionen gibt, die (aus meiner Sicht) nur sehr rudimentär in Tickets, Changelogs und der Ankündigung der Version angedeutet sind, deren praktische Anwendung allerdings oft nicht ausreichend dokumentiert ist. Bei einigen Funktionen macht das nichts, weil sie sich recht einfach im Backend nachvollziehen lassen (z.B. News-Listen mit hervorgehobenen Nachrichten zuerst), aber etwa Funktionen, die in Config-Dateien ausgelagert sind, finde ich immer nur sehr schwer nachvollziehbar – und nicht zentral dokumentiert (z.B. eine Auflistung ALLER in der config.yml zu machenden Einstellungen oder überhaupt eine Liste aller möglichen Config-Dateien und deren Aufgaben).
Vielen Dank und viele Grüße
Timo