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

Antwort per Email an