Hallo Liste,

hier der Stufenplan zur "Professionellen Dokumentation":

1. Strukturiertes Vorgehen:
Die Dokumentationsaufgaben - also der Inhalt - wird definiert mit einer Grobunterteilung Writer, Calc, Impress, Draw, Datenbanken etc. Die Feinunterteilung könnte wie folgt aussehen:
1.1 Writer
1.1.1 Der Stylist
1.1.2 Der Navigator
... etc.
1.2 Calc
1.2.1 ...etc


Jeder Punkt (wie z.B. 1.1.1 Der Stylist) stellt eine überschaubare Dokumentationsaufgabe dar, die von einem Autoren bewältigt werden kann:
- Die Doku wird mit Writer als eigenständige Datei erstellt.
- Die Doku wird je nach Lust des Autors nach den Konventionen/Schreibstil/Terminologie erstellt oder eben nicht.
- Mit der Fertigstellung wird die Dokumentationsaufgabe veröffentlicht, für welchen Zweck auch immer.


2. Die vorhandenen Dokumentation von Klaus für Calc und Writer sind z.B. eine Basis, die ausgebaut werden kann. Da diese Dokumentation nach den Konventionen/Schreibstil/Terminologie erstellt wurde, ist eine Einarbeitung in die Konventionen/Schreibstil/Terminologie relativ einfach, wenn die Doku erweitert wird.

3. Die dahinter stehenden Konventionen, der Schreibstil und die Terminologie sind (von meinem Verlag) frei gegeben und öffentlich zugänglich. Das Ziel sollte sein, zukünftige Doku in der gleichen Qualität zu erstellen.

4. Einer koordiniert die Aufgaben:
- D.h. Aufgaben verteilen, Ergebnisse einsammeln und zusammenstellen. Die einzelnen Dokumentationsaufgaben werden der Grobunterteilung entsprechend in einer Datei zusammengefasst.
- Auch dieses Werk wird veröffentlicht.
- Die Teile, die nicht den Konventionen/Schreibstil/Terminologie entsprechen, werden von einem Lektor überarbeitet. Diese Fassung bekommt das Gütesiegel "Professionelle Dokumentation". Daraus wird ein eBuch erstellt, jeweils im PDF- und im HTML-Format.


5. Jeder Freiwillige sucht sich eine Dokumentationsaufgabe raus und schreibt, soviel und solange er will. Hat er keine Lust oder Zeit, bleibt eine Baustelle zurück, die ein anderer weiterführen kann.

Hat jemand Lust, mitzumachen?

--
Mit freundlichem Gruss
Wolfgang Henderkes

_______________________________________
Handel und Technik Verlag
Wolfgang Henderkes
In der Luke 5
D-58093 Hagen, Germany

eMail: [EMAIL PROTECTED]
phone: +49-2331-3489793
fax: +49-2331-3489794
http://www.Tolaris.de
http://www.digitalbuecher.de
http://www.IT-Know-how.NET
_______________________________________


--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]



Antwort per Email an