Re: [de-discuss] [Doku] Version 3.3 und 3.4

Hallo zusammen,
Am 14.09.2011 17:23, schrieb Christian Kühl:
> Hallo, Liste,
>
> bei der Erstellung des Math-Handbuchs ist die Frage aufgekommen, ob
> dieses als Version 3.3 oder gleich als Version 3.4 herausgegeben werden
> soll. Ich möchte dazu ein Meinungsbild einholen und so ein einheitliches
> Vorgehen forcieren.
>
> Die Überarbeitung der bestehenden Dokumentation für Version 3.4 bedarf
> einer gewissen Anstrengung, da sich einige Begriffe und Menüeinträge
> geändert haben, sodass es nicht mit einer Umbenennung der Handbücher von
> Version 3.3 zu Version 3.4 getan ist, sondern eine komplette Durchsicht
> und z.T. Neuerstellung von Screenshots erfordert. Darüber hinaus müssen
> z.T. neue Funktionen ergänzt werden, die in der Version 3.3 noch nicht
> enthalten waren.

Natürlich steht es jedem frei, sich die schon bestehenden Handbücher 
herzunehmen und gleich umzusetzen. Ich würde mich aber freuen, wenn sich 
das bisher herausgebildete Doku-Team auf die Erstellung der offenen 
Kapitel und Handbücher in der vorliegenden Version 3.3 der englischen 
Versionen konzentriert.

> Deshalb:
>
> Wollen wir anstreben:
> - für einzelne Programmversion (Featurerelease) eine *komplette*
> Dokumentation zu erstellen (also zunächst für die Version 3.3 alle
> Handbücher fertigzustellen und dann zu sehen, für welche
> Programmversion wir eine aktualisierte Version der Handbücher
> herausbringen können, z.B. für die Version 3.6) oder
> - möglichst aktuelle Handbücher anbieten zu können (also die bereits
> bestehenden Handbücher für *jede* neue Version zu aktualisieren und
> erst in zweiter Linie die noch fehlenden Handbücher fertigzustellen,
> z.B. Erste Schritte ab Version 3.3, Math- und Writer-Handbuch ab
> Version 3.4, Calc- und Impress-Handbuch ab Version 3.5 usw.) oder
> - eine Mischform zu fahren und jedes Handbuch je nach Bedarf oder
> Bereitschaft der Mitstreiter sporadisch in einer aktualisierten
> Fassung herauszubringen (also Erste Schritte für Version 3.3 und dann
> für die Version 3.5, Math-Handbuch für Version 3.4 und vielleicht
> erst wieder für Version 3.8, Writer-Handbuch für Version 3.4 und dann
> für Version 3.6, usw.

Mir wäre es schon recht, wenn wir zumindest mal einen einheitlichen 
Grundstock hätten, also alle bisher gelisteten Handbücher für eine 
Version, nämlich 3.3.*)
Darauf würde ich aufbauen und Aktualisierungen fertigstellen. Diese 
können dann natürlich für ein Handbuch bei 3.4, für das andere bei 3.6 sein.

*)Wenn sich aber niemand findet, der diese Arbeit macht, wird uns wohl 
nichts anderes übrig bleiben, als für jedes Handbuch je nach Mitarbeit 
eine eigene Version zu haben.

> - evtl. sogar innerhalb der eines Handbuches
> die Kapitel für verschiedene Versionen herausbringen bzw. auslassen)?

Das setzt aber eine erhebliche Disziplin der Autoren voraus:
Es muss eine Grundversion für das Handbuch festgelegt werden (e.g. 3.3). 
Der Autor müsste in seinem Kapitel die Sachverhalte der Grundversion 
beschreiben und dann die abweichenden Sachverhalte der höheren Version(en).

Ansonsten gäbe das zumindest beim ES nur ein einziges Chaos. Stellt Euch 
mal so ein Handbuch für Erste Schritte vor: Der wirklich unbedarfte 
Leser schnappt sich dieses Handbuch Version 3.3, weil er eben die 
Version 3.3 hat und liest im Kapitel Writer Infos zu 3.3, im Kapitel 
Calc zu 3.4 und im Kapitel Impress zu 3.5. Wie soll er sich da zurecht 
finden?

Machen wir das Chaos noch ein wenig größer. Im ES-Handbuch wird Bezug 
auf ein Kapitel in einem anderen Handbuch genommen. Dieses Kapitel 
existiert vielleicht aber gar nicht mehr oder beschreibt den Vorgang für 
eine andere Version. "La vie est comme ça."

Wir können natürlich noch einen Passus einfügen.
"Das vorliegende Handbuch basiert auf der Version 3.x. In anderen 
Versionen können sowohl Bezeichnungen, Menüeinträge, Symbole, 
Abbildungen als auch Funktionen abweichen."

Grüße
k-j

--
Informationen zum Abmelden: E-Mail an discuss+help@de.libreoffice.org
Tips zu Listenmails: http://wiki.documentfoundation.org/Netiquette/de
Listenarchiv: http://listarchives.libreoffice.org/de/discuss/
Alle E-Mails an diese Liste werden unlöschbar öffentlich archiviert