Chaotikum Website

Dies ist das Repo der Chaotikum Website.

Was soll auf die Website? Was soll ins Wiki?

Es gibt hier fast keine Regeln, aber beim überdenken der Frage kann man sich folgendes überlegen: Dient die Information der öffentlichen Repräsentation und ist auch für ein fachfremdes Publikum (interessierte Laien, potentielle Förderer, Behörde,…) spannend, dann ist es eher was für die Website.

Handelt es sich um Details (Welche Marke Schmiermittel funktioniert gut? Wann wurde der Druckkopf das letzte mal gereinigt? Wie viele Millimeter Spiel bei bestimmten Arbeiten mit Gerät X, wo findet man die Option im Menü der Steuerung für...) welche erst relevant werden, wenn man intensiv mit dem Gerät oder Werkzeug beschäftigt ist? Dann vermutlich Wiki.

Eine andere Bewertung kann Änderungshäufigkeit sein. Ein einmal erstellter Inhalt auf der Website ist tendetiel eher statisch und wird nicht weiter verändert (es kommen aber natürlich häufig neue Inhalte dazu), erstellte Inhalte bleiben ca. so langfristig bestehen. Das wiki ist beliebig dynamisch, dort sollte es stattdessen nicht so viele Seiten geben um Findbarkeit zu erhalten aber diese sollen sich gerne oft ändern.

Auch ein Kriterium kann sein, dass die Website gut mit Sammlungen von Inhalten umgehen kann, da jekyll das gut verstehe und diese leicht als markdown mit Hilfe von Programmen erstellt und verwaltet werden können.

Zudem bietet das Wiki die Option für bestimmte Bereiche ein Login zu fordern. So können dort Daten abgelegt werden, die zwar nicht geheim sind (jeder mit einem LDAP Account kann sie sehen) aber die auch nicht öffentlich sind. Die Website ist öffentlich.

Basically: Inhalte auf der Website sind Repräsentativ und/oder statisch, Wiki ist Doku und soll sich den Gegebenheiten kontinuierlich anpassen.

Im Detail stimmt das ab und zu nicht. Für Dienste (BBB, git,…) ist das Wiki z.B. auch für die statische, repräsentative Sache zuständig. In anderen Punkten, z.B. im Kontext Verleih ist die Website recht nah an einer Doku. Das ist also flexibel, aber darüber sollte man immer nachdenken…

Content auf der Website erstellen

Jedes Mitglied des Chaotikums ist grundsätzlich aufgerufen Inhalte sowohl im Wiki als auch auf der Website (hier) zu schaffen, zu pflegen und zu verbessern. Wer sich unsicher ist kann diejenigen, die es bereits aktiv betreiben fragen. Einen formellen Freigabeprozess gibt es nicht. Benötigt wird ein Zugang zum Git-Repository der Website, wofür wiederum ein LDAP-Zugang notwendig ist (auch hier, einfach nachfragen sofern nicht vorhanden).

Die Website nutzt ein Jekyll und die Daten liegen im gitlab des Chaotikums. Der Master-Branch wird automatisch gebaut und deployed. Im Nachfolgenden sind einige hilfreiche Guides verlinkt, die es leicht machen sollen, neue Inhalte zu erstellen.

Doku

Die Dokumentation zur Website ist ebenfalls Teil dieses Repos. Du findest sie im Ordner docs.