HedgeDoc: gemeinsam schreiben, kontrolliert teilen
Ein gemeinsamer Entwurf braucht einen Zweck
HedgeDoc ist für gleichzeitig bearbeitete Markdown-Notizen gedacht. Das offizielle Projekt beschreibt es als Werkzeug für kollaboratives Schreiben in Echtzeit. Ein typischer Einsatz ist das Protokoll einer Besprechung: Teilnehmende sammeln Punkte parallel, ergänzen Entscheidungen und verlinken offene Fragen. Für eine freigegebene Betriebsanleitung brauchst du danach trotzdem einen festen Verantwortlichen. Ein gemeinsamer Entwurf ist noch keine geprüfte Arbeitsanweisung. [1]
Lege vor der Einladung ein kleines Format fest: Anlass, Datum, Teilnehmende, Entscheidungen, Aufgaben und nächste Kontrolle. Benenne, wer die endgültige Fassung prüft und wohin sie anschließend gehört. Eine Notiz kann schnell wachsen, wenn jeder seine Gedanken unstrukturiert anfügt; sichtbare Überschriften und kurze Abschnitte helfen gegen dieses Problem. Für dauerhafte Anleitungen bietet sich eine Trennung zu Grundlagen des Homelabs und der Backup-Planung an. So bleibt der Schreibraum beweglich, während bestätigtes Wissen wiederauffindbar bleibt.
Rechte, Datenbank und Uploads prüfen
Die Dokumentation für HedgeDoc 1.x unterscheidet Eigentümer einer Notiz, angemeldete Personen und Gäste. Für Notizen sind mehrere Stufen vorgesehen, darunter „Freely“, „Editable“, „Limited“, „Locked“, „Protected“ und „Private“. Die Stufen erlauben unterschiedliche Kombinationen aus Lesen und Schreiben; nur der Eigentümer kann die Freigabe einer Notiz ändern. Prüfe die Tabelle der Rechte, statt einen Namen wie „Protected“ intuitiv zu deuten: In der dokumentierten 1.x-Matrix dürfen bei „Protected“ angemeldete Personen lesen, bei „Private“ nur der Eigentümer. Bei „Locked“ dürfen hingegen auch Gäste lesen, aber nicht schreiben; der Name der Stufe allein verrät diesen Unterschied nicht. Eine anonym erreichbare Notiz kann auch bei unbekannter URL ungeeignete Informationen preisgeben. [2]
Das offizielle Docker-Beispiel enthält eine PostgreSQL-Datenbank und ein gesondertes Volume für Uploads. Es ist ausdrücklich als schneller Einstieg, nicht als produktionsfertige Konfiguration gekennzeichnet. Die Anleitung zeigt einen Datenbank-Dump für die Sicherung. Ergänze in deinem eigenen Plan die Uploads und die Konfiguration, falls deine Notizen Dateien enthalten oder du abweichende Einstellungen nutzt. Beschränke den Zugriff auf Datenbank und Backups und bewahre eine Kopie außerhalb des laufenden Hosts auf. Ein hochfahrender Container allein beweist nicht, dass verknüpfte Bilder und Notizen vollständig restauriert sind. [3]
Für Besprechungen mit mehreren Bearbeitenden solltest du den Zweck schon im Einladungstext nennen. Ist das Dokument eine offene Ideensammlung, dürfen unfertige Behauptungen stehen bleiben; ist es ein Beschlussprotokoll, müssen Entscheidungen und Zuständigkeiten am Ende bestätigt werden. Trenne Beobachtung, Vorschlag und beschlossenen Schritt sichtbar voneinander. Das verringert die Gefahr, dass jemand einen spontanen Einfall später als verbindliche Anweisung liest. Für langfristige Aufbewahrung genügt ein unveränderter Link nicht: Bestimme eine Person, die die Endfassung in das passende Handbuch überführt und Querverweise auf veraltete Notizen entfernt. Bei sensiblen Themen teste die Freigabe mit Gastzugriff, bevor du den Link versendest. Das Werkzeug beschleunigt das Schreiben, übernimmt aber weder Freigabe noch fachliche Prüfung.
Nutzen, Grenzen und ein konkreter Teamtest
Der Nutzen liegt im schnellen gemeinsamen Redigieren ohne Dateiversionen per E-Mail. Die Grenze ist die fehlende automatische redaktionelle Abnahme. Eine spontan angelegte Notiz kann eine Besprechung tragen, aber sie sollte nicht ohne Prüfung zum dauerhaften Nachschlagewerk werden. Vereinbare einen Ablauf: Entwurf, Kontrolle durch eine zuständige Person, Übernahme in die offizielle Dokumentation und Archivierung oder Löschung des Arbeitsdokuments. Achte besonders auf personenbezogene Informationen in Notizen, die Gäste lesen können.
Erstelle für einen Test ein harmloses Protokoll mit einer Überschrift, einer Aufgabenliste und einem kleinen Bild. Öffne es parallel mit zwei angemeldeten Testkonten und prüfe, ob Änderungen sichtbar werden. Teste dann die gewählte Berechtigungsstufe in einem privaten Browserfenster ohne Anmeldung. Kann ein Gast schreiben oder lesen, obwohl das nicht geplant war, ändere die Rechte und wiederhole die Probe. Sichere die Datenbank sowie den Uploadspeicher, stelle sie in einer separaten Umgebung wieder her und vergleiche Text und Bild. Halte die richtige Rücksicherungsreihenfolge fest; das ist wertvoller als ein Screenshot eines grünen Containers.

