Einbetten in ein wtf Handbuch? #6
Loading…
Reference in New Issue
Block a user
No description provided.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Ich bin ja immer noch nachhalting beeindruckt vom Loomio Coop Handbuch:
https://www.loomio.coop
Sourcen unter https://github.com/loomio/loomio-coop-handbook
Macht es Sinn, die Informationen im Repo hier auch in ein Handbuch einzubringen - das übrschneidet bzw. ergänzt das Thema Prozesshandbuch?
Wenn ja, würdet Ihr bspweise mdbook (nutzt md-Dokumente als Input) oder Sphinx (nutzt .rst) bevorzugen?
Ist nicht direkt ein Issue, ich weiss, aber hier schauen evtl. die Leute mit Interesse?
Persönlich empfinde ich Markdown in 95% aller Bücher als hinreichend. Details lassen sich mit HTML oder LaTeX ergänzen. Selbst Profis müssen Restructured Text ständig nachschlagen, Markdown zwingt schon beinahe zu Einfachheit und einer gründlichen Abwägung es nicht kompliziert werden zu lassen. Das finde ich zumeist auch sehr gut.
Und ich empfinde Verwendung von Issues als sehr passend. :)
Das genannte Buch ist auch eine wunderbare Leseempfehlung. Würde ich mir ziehen, wenn Gitbook nicht erst noch Dinge (Verfikation Mobilfunknummer) haben wollte, die ich nicht erbringen mag. (Das Alter ist mit >5 Jahren natürlich auch ein Hinweis auf ggf. notwendige/ausstehende Aktualisierungen)
Sobald wir es in ein Handbuch einbringen können wir auch nochmal die Struktur der Daten überdenken um die Integration zu verbessern.
Es gäbe noch:
https://handbook.enspiral.com
Und eine Menge weiteres Material auf:
https://community.coops.tech/t/examples-of-governing-documents-handbooks-constitutions/101
👍 für Markdown
ich probier mal mdbook bzw. crowbook aus. Mal sehen, ob auch das loomio Handbuch damit funktioniert. siollte mit rustup und cargo install ziemlich einfach zu installieren sien.
Alternativ gäbe es noch einen Markdown-Parser im Sphinx (https://www.sphinx-doc.org/en/master/usage/markdown.html).
Nur mal der Vollständigkeit halber: Nextcloud 22 bietet jetzt auch Knowledge Management. Ist die Frage, wie schnell das bei Hetzner ankäme und ob das dann auch taugt.
Ich glaube wir brauchen definitiv ein Knowledge Management System.
Sicherlich ist es auch sinnvoll Themen wie Conflict Resolution und Improvement lifecycle zu spezifizieren. Bei manchen Menschen nimmt das sicherlich auf die Hemmschwelle "aha die Leute wollen ja, dass ich Verbesserungen vorschlage!"
Ist mir je sympathisch weil "existiert eh schon als Tool bei uns". Für weniger Verstreuung von Dingen! Wäre ich auch für zu haben. Ansonsten ist Markdown bei mir auch hoch im Kurs weil simpel und "eh schon da/bekannt".
Find ich auch gut. Habe Helix/handbuch erstellt und alle an dieser Issue Teilnehmenden dort eingeladen. Wer Zugriff will, sagt mir einfach fix hier oder im Forum bescheid.
Fürs rendern gibt es temporär das Repo gulliver/rtfm, Ergebnisse liegen in der Nextcloud
Ist ins Handbuch übernommen, deshalb wird issue hier geschlossen.
Wird das Repo selbst auch geschlossen und Teil des Handbuchs oder wird es koexistieren?
Ich würde es vorerst hier belassen, da es verlinkt ist.
Müssen wir längerfristig klären.