BitteAktualisieren: Wiki-Seite "Dokumentation"
Liebe Liste,
Christian und Andreas weisen zu Recht darauf hin, dass
http://wiki.skolelinux.de/Dokumentation dringend einer Überarbeitung
bedarf.
Der Vorschlag, sich an der internationalen Seite zu orientieren, ist
sicher hilfreich. Da "Dokumenation" auch eine Seite ist, auf die direkt
von der Startseite verwiesen wird, gilt es m.E. aber zunächst zu
eruieren, was hinter diesem Begriff erwartet wird:
Ist nicht jede Form der Information auch eine Dokumentation? Wo ist die
Grenze zu ziehen? Das Archiv der Mailingliste dokumentiert zwar unsere
Kommunikation - wird hier aber sicher nicht erwartet. Anders sieht es
da evtl. schon mit der FAQ aus, die aus der ML erwachsen sollte. Was
ist mit Anleitungen/Howtos? Können wir hier bestehende Kategorieren
nutzen?
Sollten wir auch auf internationale Dokumentationen verweisen -
wenigstens da, wo eine deutsche Übersetzung fehlt?
Macht es Sinn, primär nach Versionen (1.0/2.0/3.0) zu gliedern? Vieles
aus dem Woody-Driftbook hat heute noch Gültigkeit - und wird nun nicht
mehr gefunden. Die bestehende Unterteilung erfolgte m.E. nur aus
Bequemlichkeit - bei jedem Release wurde das Bestehende eine Ebene nach
hinten verschoben.
Dokumentation kann neben dem Ergebnis (z.B. Handbuch) auch den Prozess
bezeichnen. Wie kann die Seite gleichzeitig Ergebnisse dokumentieren
(dazu gehören m.E. auch die UseCases) und einladen zum Mitmachen?
Fragen über Fragen. Seid mutig und bringt eure Ideen direkt auf der gen.
Seite ein ;)
Herzlich
Ralf
Reply to: