bolug bonner linux user group
news about wissen files archive hilfe suchen  

 

archive :: SchAN-User

druckfassung

SchAN-User

Re: [Schan-user] Versionen

To: Schulen ans Netz - Anwender <schan-user@xxxxxxxxxxxxxxxxx>
Subject: Re: [Schan-user] Versionen
From: Uwe Schoffer <uwe@xxxxxxxxxxx>
Date: Sat, 29 Sep 2007 13:35:15 +0200
Helmut Hullen schrieb:

Eine (oder mehrere) überarbeitungswürdige Seiten einer guten Doku
gegen eine seit Jahren völlig vernachlässigte Dokumentation
aufzuwiegen, das hat schon was...

"völlig vernachlässigt" - könntest Du bitte konkret benennen, welche Kapitel oder Absäze inhaltlich überarbeitet werden müssen? Ein Rundschlag hilft da nicht so recht weiter.

Gut, ich werde versuchen bei der Arbeit zu helfen.

Ich beschreibe einfach, wie bei der Überarbeitung der Doku zu ArkturV4.0 vorgegangen wurde. Wenn Du diesen Weg einfach nachvollziehst, kommt auch für Arktur 3.4 eine aktualisierte Doku raus.

Zuerst wurde eine klare Lizenz für die Doku gesucht. Die Entscheidung fiel zugunsten der GFDL. Zum nachlesen http://www.gnu.org/copyleft/fdl.html

Dann wurden alle Autoren angeschrieben, die einen Artikel in der alten Doku verfasst hatten. Nur nach deren schriftlicher Zustimmung wurde der jeweilige Artikel ins wiki zwecks Überarbeitung übernommen. Hat der Autor nicht zugestimmt, oder gar nicht geantwortet, dann wurde das Kapitel komplett neu geschrieben.

Jetzt kam die Gliederung dran. Eine gute Dokumentation soll sich ja an der jeweiligen angesprochenen Zielgruppe orientieren. Daher fiel die Entscheidung auf 4 verschiedene Handbücher. Dazu kam noch ein freier fünfter Abschnitt für all das, was nicht direkt in ein Handbuch passte.

Nun wurden potenzielle Autoren kontaktiert, die sich dann Kapitel für Kapitel einzeln vorgenommen haben. Jeder Satz wurde überprüft, ergänzt oder gegebenenfalls neu geschrieben.

Dann kamen noch aktuelle Bildschirmfotos hinzu, damit die Doku auch für die Augen etwas hergibt.

Die Ergebnisse dieser Arbeit kann jeder unter http://arktur.schul-netz.de/wiki/index.php/Arktur4:Hauptseite nachprüfen.

--

mit freundlichen Grüßen

Uwe Schoffer

_______________________________________________
schan-user mailing list
schan-user@xxxxxxxxxxxxxxxxx
http://www.heise.de/bin/newsletter/listinfo/schan-user

 

seitenanfang


 

news about wissen files archive hilfe suchen  
kontakt letzte änderung: 29.09.2007