OPUS 4 Handbuch für Anwender und Administratoren. Das Git-Repository für das Handbuch befindet sich hier:
https://opus4.github.io/userdoc
Probleme mit der Dokumentation, Hinweise und Vorschläge, können als Issues gemeldet werden. Bitte dabei vorher prüfen, ob es eventuell schon ein entsprechenden Issue gibt.
Fehlerkorrekturen und Änderungen können als Pull Requests zur Verfügung gestellt werden. Hinweise dazu finden sich in der GitHub Dokumentation. Auf diesem Weg kann die OPUS 4 Community mit der Dokumentation helfen. In der Regel sollte ein Issue angelegt werden before an neuen Inhalten gearbeitet wird, um die Änderungen koordinieren zu können und doppelte Arbeit zu vermeiden.
Die Dokumentation verwendet GitHub Pages, um aus Markdown Dateien (.md) statische Webseiten zu generieren. Dafür wird Jekyll verwendet. Für das Rendern der Markdown Dateien verwendet GitHub Pages momentan Kramdown.
Eine Referenz für die von Kramdown unterstützte Synstax ist online verfügbar. In der Entwicklerdokumentation von OPUS 4 finden sich weitere Hinweise zum Erstellen der Dokumentation.
Hinweise zur Verwendung von Jekyll finden sich in der Dokumentation zu GitHub Pages. Dort steht auch wie man Jekyll lokal einrichten kann, um die generierten Seiten lokal prüfen zu können bevor die Änderungen zu GitHub hochgeladen werden.