Aufgabe #1710
offenAufgabe #1701: Erstellung Dokumentation zur Verwendung von Nix Flakes
Festlegung Ort der Dokumentation von Flakes
0%
Beschreibung
Vater sagte, dass im StuRa üblicherweise alles How-To-artige auf der Website im Plone geschrieben wird. Allerdings fanden wir beide das, auch angesichts der Tatsache dass es ein Wiki (und andere für Dokumentation besser geeignete Orte) gibt, nicht ganz so sinnvoll. Wenn ich mich recht erinnere, kam daher die Idee, dass die Dokumentation andererorts stattfindet und auf der Webseite als solche nur verlinkt wird.
Dennoch stellt sich dann die Frage, wo die Dokumentation abgelegt werden sollte.
Von SoerenBoxberger vor mehr als 1 Jahr aktualisiert
Forgejo¶
In Forgejo kann man für jedes Repository ein Wiki erstellen, was in dem Fall nur sinnvoll wäre, damit die Doku direkt neben der Flake liegt.
Allerdings sind die Repositories nur für eingeloggte Nutzer sichtbar.
Leider gibt es auch noch keine Dokumentation zur (immernoch testweisen) Verwendung von Kanidm und der Erstellung von Accounts mit den entsprechenden Rechten darin.
Zur Not kann man sich immer mit den "den 8" auch ohne Kanidm einloggen.
Alternativ könnten wir auch das Lesen von Repositories für nicht angemeldete Nutzer zulassen und die Dokumentation in einem eigenen öffentlichen Repo führen, sodass alle anderen auf "privat" geschalten werden müssen.
MediaWiki¶
Sicher geht auch das, wobei ich persönlich, mindestens in diesem Fall, nicht so angetan davon bin.
Von SoerenBoxberger vor mehr als 1 Jahr aktualisiert
- Status wurde von Neu zu Feedback geändert
Mindestens der Startpunkt für die Dokumentation wie man mit Flakes im StuRa arbeitet, soll auf der Website liegen: https://www.stura.htw-dresden.de/stura/ref/verwaltung/admin/nixos/how-to/how-to-nix-flake-s
Der Rest darf im Repository mit der Flake dokumentiert sein.
Ist das so richtig vat@?
Von SoerenBoxberger vor mehr als 1 Jahr aktualisiert
- Zugewiesen an wurde von Bereich Administration Rechentechnik zu PaulRiegel geändert