Hi Tobias,
ich werde einige Bestandteile der Doku in Sphinx abbilden.
Ich habe heute damit begonnen, die Druckerdoku, die ich mal erstellt
hatte und bei der Du ja auch schon commits eingereicht hast, zu
ergänzen. Ich habe meine commits hochgeladen.
Wie war das nochmal mit der Zusammenführung, wenn ich das richtig in
Erinnerung habe, konnte das nur Frank Schiebel ??? Sonst sehen wir ja
noch immer die alte Dokuversion.
Wäre nett, wenn Du mich nochmal auf den aktuellen Stand bringen könntest.
VG
Christian
Am 29.05.2016 um 16:51 schrieb T. Küchel:
Liebe linuxmuster.nett-Gemeinde,
der Betatest zum Release 6.2 steht bevor.
Wir hinken mit der neuen Dokumentation noch etwas hinterher und wären
für kurz+langfristige Hilfe sehr dankbar.
Schau mal zunächst hier:
[1] https://www.linuxmuster.net/wiki/dokumentation:startneu
Hier sieht man bildlich, dass es einige Baustellen gibt.
In Form von Tickets gibt es feiner dargestellt auch eine Liste an
Tickets [2]
Jetzt gibt es drei Möglichkeiten zur Mithilfe:
Möglichkeit 1: Bestehende Dokumentation auf Stimmigkeit überprüfen und
Feedback geben.
======================================================================================
Die bereits neu erstellten Dokumentationen (hauptsächlich
"installation", "linuxclients", "windows10clients", "leoclient")
könnten vor allem Betatester auf ihre Stimmigkeit überprüfen. Bei
Fehlern oder jeglichem Feedback, wäre
- die beste Idee als Mitglied im Dokuteam per git direkt einpflegen
([3], rst-Kenntnisse, git-Kenntnisse hilfreich),
- die zweitbeste, aber simpelste Idee ist, ein Ticket hier zu
schreiben: [2]
(flyspray-Konto nicht erforderlich, aber hilfreich)
Möglichkeit 2: Neue Doku auf Basis alter Wikieinträge schreiben.
================================================================
Beim letzten Arbeitstreffen haben einige von euch schon fleißig
Erfahrung mit "git, "sphinx" und der Markup-sprache "rST" gesammelt
und die bestehende Doku erstellt.
Wie die in [1] offensichtlich fehlenden Dokumente erstellen?
- Für nahezu jedes Ticket in [2] habe ich ein Repo in github erstellt
- [3] zeigt dir alle weiteren Schritte
- [4] zeigt dir, nach welchen Leitlinien die Doku geschrieben werden
sollte,
- [5] zeigt dir ein (privates) preview, wie es am Ende aussehen könnte
Möglichkeit 3: Die Liste verfolgen und Ticket anlegen
=====================================================
Immer wieder gibt es in der Liste Empfehlungen, die Dokumentation
zu verbessern, bisher gibt es fast niemanden, der aus diesen Hinweisen
Tickets erstellt, oder noch besser: die Dokumentation ändert.
Für jegliche Hilfe gibt es ein dickes Dankeschön,
persönlich, wenn du beim Grillen dabei bist,
es grüßt dich (im Auftrag des Dokuteams und der Entwickler)
Tobias
Links:
[1] https://www.linuxmuster.net/wiki/dokumentation:startneu
[2]
http://www.linuxmuster.net/flyspray/index.php?project=3&do=index&switch=1
[3] https://www.linuxmuster.net/wiki/dokumentation:sphinx
[4] https://www.linuxmuster.net/wiki/dokumentation:handbuch_zum_handbuch
[5] http://bit.ly/1WTjzsX
_______________________________________________
linuxmuster-user mailing list
[email protected]
https://mail.lehrerpost.de/mailman/listinfo/linuxmuster-user
_______________________________________________
linuxmuster-user mailing list
[email protected]
https://mail.lehrerpost.de/mailman/listinfo/linuxmuster-user