Der seit 2020-12-01 auf docs.linuxfabrik.ch verfügbare kleine Admin-Leitfaden ist keine umfassende Einführung in Linux, sondern hilft uns selbst, viele Aufgabenstellungen nach "Best Practice"-Manier zu lösen.
Das Handbuch fasst Themen zusammen, die im Linux-Admin-Alltag immer wieder anfallen: Cheat Sheets, HowTos, Tipps und Tricks sowie die nötigen Hintergrundinformationen. Teile der Inhalte stammen ursprünglich aus den CentOS-Büchern von Markus Frei und sind über die Jahre zu einer gepflegten Sammlung gewachsen.
Unsere Linux System Engineers nutzen das Handbuch täglich als interne Referenz. Wenn jemand zum ersten Mal eine bestimmte Software ausrollt, gibt es eine Schritt-für-Schritt-Anleitung. Wenn jemand etwas Bewährtes ein zehntes Mal aufsetzt, ist die Vorgehensweise nachvollziehbar dokumentiert und reproduzierbar.
Wir haben uns früh entschieden, diese Sammlung öffentlich zu machen. Open Source lebt von geteiltem Wissen, und gut dokumentierte Aufsetz-Anleitungen sind in der Praxis selten. Viele Projekte beschreiben das was, aber nicht das wie es im Alltag wirklich läuft. Unsere Doku versucht, beides zu liefern.
Schwerpunkte:
Eingebettet sind ausserdem die offiziellen Dokumentationen unserer eigenen Open-Source-Projekte:
Die Inhalte schreiben wir in reStructuredText im selben Workflow, in dem wir auch sonst arbeiten: direkt im Editor (Sublime Text, vim) und versioniert in Git. Sphinx mit dem readthedocs-Theme rendert die RST-Dateien zu HTML.
Die Inhalte sind unter CC BY-SA 4.0 freigegeben. Sie dürfen bearbeitet und weiterveröffentlicht werden, solange der Autor genannt wird und das Ergebnis unter derselben Lizenz steht.
Die Doku ist nicht abgeschlossen und nie vollständig oder fehlerfrei. Sie wächst mit jedem neuen Kunden-Setup, jeder neuen Distribution und jeder Best Practice, die sich in der Praxis als richtig erwiesen hat. Feedback ist willkommen.
