Mehr liebe für die user docu #41
Description
Ausgangslage
Die Userdoku hat einige technische Probleme so schlägt der Build fehl und die Übersetzungen müssen manuell von einem technisch versierten User aktualisiert werden. Transifex soll weiter verwendet werden, da hier bereits die Übersetzungen von Hitobito vorhanden sind.
Hier einige Diskussionsgrundlagen
Transifex Plugin verwenden
Transifex biete ein github Plugin welches die Kommunikation zwischen github und transifex übernehmen würde. Dadurch automatisiert sich der Prozess und wird hoffentlich etwas robuster.
Readthedocs deployment sicherstellen ✔️
Aktuell schlägt der Build fehl und die Seite https://hitobito.readthedocs.io/ wird nicht mehr aktualisiert. Die Jubla hat das gleiche Problem: #34. Anstelle viel Aufwand fürs fixen zu investieren könnte passend zu Hitobito 2.0 die Seite komplett neu erstellt werden und die bestehenden Texte (inkl Übersetzungen) übernommen werden.
Alternative: Github Pages verwenden ❌
Anstelle der readthedocs.org könnte die Seite auch direkt mit github pages gebaut werden. Nach meiner kurzen Recherche müssen Rst files zu md konvertiert werden und Übersetzung geklärt werden. Mögliches jekyll-locale Plugin
Zu beachten/Weiteres:
- Bei einer Umstellung darauf achten, dass die bereits bestehenden Übersetzungen nicht verloren gehen.
- Gewisse Bilder sind noch bei https://content.screencast.com/users/RolandStuder/folders/Jing/media/* ✔️
- Schön wäre es noch ein redirect von docs.hitobito.ch zu haben.