8000 Alte Handbuch Versionen parallel zur aktuellen Dokumentation verfügbar machen · Issue #113 · OPUS4/userdoc · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Alte Handbuch Versionen parallel zur aktuellen Dokumentation verfügbar machen #113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
j3nsch opened this issue Aug 23, 2022 · 0 comments

Comments

@j3nsch
Copy link
Member
j3nsch commented Aug 23, 2022

Die Dokumentation für 4.7 unterscheidet sich deutlich von 4.6, insbesondere bei der Anpassung von Übersetzungen. Alle OPUS 4 Instanzen sollten die neueste Version nutzen, aber mittelfristig könnte es notwendig sein, dass die alte Dokumentation weiterhin verfügbar ist.

Dafür muss eine gute Lösung gefunden werden. Leider ist es mit GitHub Pages nicht möglich mehrere Branches zu veröffentlichen. Die alten Dokumentation müsste also in ein Unterverzeichnis kopiert werden, was die Seiten für die verschiedenen Version von einander trennen würde.

Alternativ könnte man vielleicht mit mehreren Repositorien arbeiten. Die GitHub Pages für eine ältere Version könnten in einer Subdomain angezeigt werden. Das müsste getestet werden.

Wenn wir aus der Dokumentation nicht nur eine statische Website, sondern auch ein PDF generieren könnten, wäre es möglich die alten Dokumentation einfach als Datei für den Download verfügbar zu machen. Ich habe momentan noch keine Ahnung, ob es für Jekyll Themes bzw. Tools gibt, die das erlauben würden.

Ich denke die Verwaltung der Dokumentation in einem Git-Repository auf GitHub ist wichtig und einem externen Tool, dass nicht frei zugänglich ist vorzuziehen.

Zusätzlich zu GitHub Pages gäbe es auch noch die Wikis auf GitHub. In der Vergangenheit waren sie zu eingeschränkt für unsere Nutzerdokumentation, aber sie könnten für grundlegende Informationen und vor allem für Entwickler genutzt werden.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant
0