Hallo Denis, hallo @all,
Denis schrieb:
Hui! Das macht ja hier die Runde! :-)

So ist es gedacht und gewollt!
[...]
Nur noch so eine Frage am Rande. Ich weiss, dass ich mich mit euch nicht
"messen" sollte, aber rein der Neugier halber: wie lange braucht man so
im Schnitt für die Überarbeitung so eines Dokumentes?
Das hat nicht mit messen zu tun!

Die Zeit, die man für ein Dokument braucht, ist abhängig von verschiedenen Faktoren:

Zuerst natürlich, ob man die Zeit findet, ein Dokument "in einem Rutsch", d.h. ohne Störung zu lesen, oder ob man dabei unterbrochen wird :-).

Zweitens ist es sehr nützlich (eigentlich unumgänglich), sich mit der Materie, die das Dokument behandelt, auseinander zu setzen.

Zur Verdeutlichung: Du hast Dir ein Dokument vorgenommen, was hinsichtlich der Erstellung und Überarbeitung für den Einstieg recht anspruchsvoll ist (auch wenn es auf den ersten Blick nicht so scheint).

Warum? Ganz einfach, es geht hier um grundlegende Einstellungen für OpenOffice.org, die im Dialog Optionen in den verschiedensten Reitern versteckt sind.

Da das Dokument auf BETA-Software basiert, kann es vorkommen, dass sich bestimmte Sachen ändern, z. B., dass eine Option woanders eingestellt wird, als vorher (im derzeitigen Status der BETA2 eher unwahrscheinlich, aber nicht völlig ausgeschlossen), dass sich Bezeichnungen ändern (kann vorkommen...) und ähnliches.

Um feststellen zu können, ob der Text des Dokumentes richtig ist, musst Du die beschriebenen Schritte selbst nachvollziehen, dass kostet natürlich Zeit ...

Da was mir als Autor (Übersetzer) logisch und verständlich erscheint, muss es für einen potentiellen Leser noch lange nicht so sein.

Was bedeutet das? Nun, wenn man Korrektur liest, muss man sich quasi in einen Leser versetzen, der zum ersten Mal mit der Materie konfrontiert wird, dass bedeutet, es sollte wenig oder nichts als bekannt voraus gesetzt werden.

Ich persönlich (!)gehe beim Lesen so vor (andere haben ihre eigene, vielleicht für sie bessere Lösung ;-) )
1. Stimmt die Beschreibung mit der Wirklichkeit (noch) überein
2. Ist der richtige Screenshot abgebildet? (Macht er Sinn für die Beschreibung)
3. Ist der Screenshot noch aktuell?
4. Ist die Beschreibung verständlich (Verstehe ich auf Anhieb, worum es hier geht)?
5. Ist die Rechtschreibung/Grammatik ok?
6. Kann die Beschreibung verbessert werden (KÜRZER-VERSTÄNDLICHER-KLARER)?

Wie Du siehst kommen (bei mir!) Rechtschreibung und Formulierung ganz am Ende.

Warum? Es macht keinen Sinn, einen Satz umzustellen, der sich später als sachlich falsch oder als von der Wirklichkeit überholt erweist.


Wie Du siehst, ist es schon ziemlich (Zeit-)aufwendig. Das ist etwas, was man am Anfang oft unterschätzt, weil man es nicht wissen kann. Auch ich persönlich musste das erst verstehen und für mich meinen Weg finden.

Abschliessend noch folgende Tipps:
*Nutze die Option zur Überarbeitung von Dokumenten in OOo
*Kommentiere und begründe Deine Änderungen, die Du am Dokument
 vorgenommen hast(z. B. durch eine Mail an den Autor)
*Denke daran, dass sich bei der Vielzahl der Aufgaben nicht alle Leser
 der dev für das Thema Dokumentation interessieren. Wende Dich also
 (wenn Du mit dem Dokument fertig bist) erst einmal an den/die Autoren
 direkt :-)

Und zum Schlug: Es gilt auch hier der Grundsatz "Manchmal ist weniger mehr!" Auch mir fällt es manchmal schwer, mich daran zu erinnern :-)

Danke an jeden, der es bis hierher, ans Ende dieses Textes geschafft hat!

Viele Grüße!
Marko


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

Antwort per Email an