Hallo Andreas,

Andreas Borutta schrieb:
Wolfgang Henderkes schrieb:

  
... ist in der Softwareentwicklung die Dokumentation. Das ist 
naheliegend, weil Software eh nie fertig wird und eigentlich nur das 
dokumentiert werden kann, was fertig ist.

Also ist und bleibt auch die Doku eine Dauerbaustelle, die hier im 
Projekt gut bearbeitet werden könnte.
    

Eine Anregung:
Das Schreiben der Doku ist eine undankbare Aufgabe. Sie ist sehr
anspruchsvoll und kostet viel Zeit.
  
Beides richtig. Unter dem Motto "Professionelle Dokumentation" gibt es bereits zwei Beispiele (je eins für Writer und Calc), wie die Doku im Idealfall aussehen sollte. Die haben Klaus Endelmann (als Autor) und ich (als Lektor) geschrieben.
Daher wäre es gut, wenn sie auf viele Schultern verteilt wird.
  
Das Problem liegt in der Abstimmung. Oben zitierte Beispiele verwenden eine einheitliche und fest definierte Terminologie, die in dem HuT-eSaurus öffentlich zugänglich ist.  Außerdem verwenden die Beispiele einen Sprachstil und natürlich ein Erscheinungsbild. Alles zusammen wirkt auf Einsteiger erst mal abschreckend. Deswegen meine grundsätzlich formuliererte Frage, ob jemand Lust hat. Danach sprechen wir über Details.
Habt ihr schon darüber nachgedacht die Doku mit Hilfe eines Wikis
(oder auch eines CMS) zu bearbeiten?
  
Ja, ich halte aber nichts davon. Ich erstelle 600 Seiten starke Dokumente mit Writer und habe eben auch alle Möglichkeiten, die Writer bietet. Diesen Vorteil möchte ich nicht verlieren. Trotzdem klappt die Koordination im Team.


-- 
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
_______________________________________

Antwort per Email an