Zikula Core Dokumentation in neuem Gewand

in  Zikula Apps , ,

Zikula Core Dokumentation in neuem Gewand

Schon seit einiger Zeit werden im GitHub-Repository des Zikula Core die Dinge dokumentiert, die zusätzlich zu den Handbüchern von Symfony, Doctrine, Twig, Bootstrap usw. zu beachten sind. Nun wurde die Struktur dieser Dokumente jedoch überarbeitet und in eine Gesamtsicht gekleidet.

Themenorientiert

Frühere Ansätze von Handbüchern und Doku-Sammlungen haben oft versucht, unterschiedliche Bereiche für Entwickler und Administratoren aufzubauen. Dies hatten wir wieder versucht, sind dann aber zu der Erkenntnis gelangt, dass es zu viele Überschneidungen gibt und das Ganze vor allem unübersichtlich wird.

Daher unterteilt die neue Struktur die Dokumentation nun in verschiedene thematische Schwerpunkte: zum Beispiel findet sich unter “Access Control” alles zu Benutzern, Authentifizierung, Gruppen und Zugriffsrechten. Die Dinge, welche jeweils nur für Entwickler relevant sind, werden am Ende eines Themas in einem gesonderten Abschnitt gesammelt.

Auch auf externe Ressourcen, wie etwa Symfony-Docs oder Infos zu bestimmten Bundles, wird ebenfalls an den entsprechenden Stellen verwiesen.

Wo ist die Seite?

Die Doku-Seite ist unter der Adresse https://docs.ziku.la erreichbar.

Einfache Pflege

Da die Dokumentation aus den Markdown-Dateien im Core-Repository gespeist wird, lässt sie sich leicht ergänzen und erweitern. Es entsteht somit kein nennenswerter zusätzlicher Aufwand und die Aktualisierung der Doku erfolgt nach jeder Änderung vollautomatisch.

Was fehlt?

Wichtig war es in diesem Schritt, die Struktur so zu verändern, dass sie sowohl intuitiv als auch erweiterbar ist. Natürlich ist hier das letzte Wort noch nicht gesprochen, es ist alles im Fluss. Auch viele Inhalte sind noch unvollständig oder fehlen aktuell sogar noch komplett.

Weitere Beiträge in Kategorie Zikula Apps

Zikula Core 3.0.3 mit Sicherheits-Update von Symfony 5
- Vor kurzem hatten wir über das Release von Zikula 3.0.1 berichtet, welches wichtige Korrekturen für Zikula 3 bereitgestellt hat. Vor einer Woche wurde die nächste Version 3.0.2 veröffentlicht. …
Symfony Services asynchron im Hintergrund aufrufen
- Oftmals greift man in Symfony-Projekten auf CLI-Kommandos mit Hilfe der Symfony Console-Komponente zurück, um länger laufende Prozesse außerhalb des Webservers durchzuführen. In komplexeren Vorhaben …
Zikula 3.0.1 veröffentlicht - erstes Bugfix Release für Zikula Core 3
- Genau einen Monat nach der Veröffentlichung von Zikula 3.0.0 ist nun das erste Update erschienen. Zikula 3.0.1 bringt wichtige Korrekturen und sorgt somit für ein Stück mehr Stabilität in der neuen …
Zikula Framework in Version 3 veröffentlicht
- Heute haben wir das finale Release von Zikula Core 3.0.0 veröffentlicht. Es basiert auf Symfony 5.1 sowie Twig 3 und verwendet unter anderem Bootstrap 4 und Font Awesome 5. Einen grundlegenden …
Zikula 3 erscheint als Release Candidate
- Heute wurde der erste Release Candidate für Zikula Core 3.0.0 veröffentlicht. Einen grundlegenden Überblick über die wichtigsten Änderungen sowie die weiterführenden Links zur Dokumentation und zu den …