Hallo Stefan, *, Am Freitag 09 Oktober 2009 09:30:41 schrieb Stefan Weigel: > Hallo Andreas,
(...) > Das ist im übrigen nicht nur ein Problem im dem Sinne, dass man die > Doku ständig überarbeiten muss. Die sich ständig ändernden Dokus > müssen auch gemanaged werden. Idealerweise gibt es überall dort, wo > eine Doku hin verteilt wurde, eine Benachrichtigung, wenn es eine > neu überarbeitete Ausgabe gibt. > das spricht dann dafür, sie nur in einem Framework zu bearbeiten und zu veröffentlichen (allenfalls zwei wegen der Performance). Die Benachrichtigung ließe sich evtl. mit News-Feed regeln. Wenn wir die Docs managen wollen, müssten wir einen Release-Manager haben, hoffentlich nicht hauptamtlich ;-) Am einfachsten ließe sich auch dies über ein Framework mit implementierten Workflow lösen. Dort wäre die anstehende Arbeit für alle Beteiligten sichtbar und Arbeiten könnten mit Prioritäten versehen werden, denn bei wesentlichen Programmänderungen ist eine Überarbeitung dringender als bei Funktionen, bei denen sich lediglich die Benennung aber nicht die Arbeitsweise geändert hat. > Aus diesem Grund plädiere ich sehr dafür, dass es für die > Dokumentationen ein zentrales Repository (meinetwegen OOoAuthors) > gibt und dass sie nicht an diversen Orten vorgehalten oder sogar die > gleichen Dokumente an diversen Orten editiert werden. > +1 > Aber auch dann stellt sich die Frage, ob es jemals realistisch > erreichbar sein wird, eine einigermaßen vollständige und stets > aktuelle Benutzer-Dokumentation anzubieten. Vollständig hieße zu > jedem Modul ein umfassendes Handbuch für Einsteiger und > Fortgeschrittene. Selbst wenn man dies erreicht hätte, bräuchte es > eine Heerschar von koordinierten Autoren, die zu jedem Release, also > alle 6 Monate, alles auf den neuesten Stand bringen. > Ich glaube im Moment auch nicht, dass wir diese Autorenschar so schnell auf uns zukommen sehen. Deshalb sollten wir an unserer kurzfristigen Zieldefinition arbeiten und uns realistische Ziele setzen. > Der übliche Workflow, dass Dokumente meist erst in Englisch erstellt > werden und wenn sie dann mal fertig sind, auf Deutsch übersetzt > werden, bringt zusätzlich Verzögerungen. Abgesehen davon habe ich > auch schon erlebt, dass das englische Material inhaltlich > unbrauchbar war. > Ist sicher im Moment so. In der Vergangenheit war es auch schon einmal so, dass das Original in deutscher Sprache erstellt worden ist und übersetzt wurde. Die Anzahl der Übersetzer für Dokumentationen ist im Moment seeeehr überschaubar. Deshalb ist es m.E. wenig realistisch, die für OOo3 verfügbaren englischen Originale demnächst in deutscher Fassung zur Verfügung zu haben. > Das alles stellt IMO in Frage, ob das Ziel, eine umfassende > Benutzerdokumentation in Form von download- oder druckbaren > Dokumenten anzubieten, strategisch richtig ist. Vielleicht wäre es > realistischer, sich auf einige, wenig umfangreiche > Einführungsdokumente zu beschränken, die aber wirklich immer > topaktuell gehalten werden. Weiter gehendes Wissen könnte dann über > Foren, Mailinglisten und deren Archive angeboten werden. Wobei die > in diesen Medien häufig auftretenden Themen in einem Wiki als FAQ > oder als Schwerpunktaufsatz behandelt werden könnten. > Ich halte im Moment auch Einführungsdokumente für die realistische Perspektive. Diese sollten allerdings dann auch durch einen Workflow mit Überarbeitung / Korrekturlesen gehen. Kurze, eventuell sich schnell ändernde Infos sind im Wiki als FAQ oder Themenseite sinnvoll. Das CVS ist hierfür aus meiner Sicht, der falsche Ort. > Zum Teil funktioniert es ja derzeit schon genau so. Vielleicht > würden wir uns verbessern, wenn wir dies auch bewusst (oder noch > bewusster) so organisieren an die Benutzer kommunizieren würden. Vielleicht. Aus meiner Sicht wäre es wichtig, neue Mitarbeiter zu gewinnen, die eben diese kurzen Texte schreiben (und evtl. auch später mal eine längere Dokumentation). Wobei das Formatieren im Wiki auch nicht unbedingt jedem liegt (glücklicher Weise gibt es einen Exportfilter). Gruß Andreas -- ## Content Developer OpenOffice.org: lang/DE ## Freie Office-Suite für Linux, Mac, Windows, Solaris ## http://de.openoffice.org ## OpenOffice.org Portable: http://oooportable.org ## Meine Seite: http://www.amantke.de --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
