Hilfe beim Verfassen technischer Dokumente
Einführende Zusammenfassung
Ich biete Hilfe zum Schreiben technischer Dokumente an. Diese Hilfe umfasst sowohl interne/vertrauliche Berichte/Dokumente als auch externe Veröffentlichungen. Sie erfolgt in mehreren Stufen, so dass die Autoren das Schreiben übernehmen können, wann immer sie sich in der Lage fühlen, die Schreibarbeit allein zu Ende zu führen. Ich verfasse einen ersten, aber ausgereiften Entwurf; die Autoren bewerten diesen Entwurf, korrigieren ihn in ihrem eigenen Schreibstil. Ferner tragen die Autoren alle Abbildungen, Formeln/Gleichungen und Referenzen selbst bei. Am Ende sind die Autoren ausschließlich für den gesamten Inhalt des Dokuments verantwortlich.
Mein technisches Schreiben schreitet in mehreren Schritten voran mit wohl definierten Ergebnissen, Lieferzeiten und Kosten. Ich gehe davon aus, dass jeder Schritt einer Woche bedarf. Sollten die Autoren eine schnellere Antwort wünschen, kann dem gegen einen Aufpreis entsprochen werden. Die endgültigen Autoren sind sowohl für ihre eigenen als auch für alle formellen Korrekturen des Dokuments selbst verantwortlich. Sie sind auch verantwortlich, das Dokument bei einem Verlag ihrer Wahl einzureichen.
Die Vier Schritte zum Erstellen eines technischen Dokuments
Schritt 1: Gespräch mit dem Hauptautor (oder Korrespondenzautor), Erstellen einer Zusammenfassung und Inhalt auf oberster Ebene (Inhaltsverzeichnis)
Im ersten Schritt führe ich mit dem Hauptautor oder dem Korrespondenzautor, der die Autoren nach außen vertritt, ein Gespräch über das gewünschte Dokument. Der Haupt- oder Korrespondenzautor stellt mir das Thema des Dokuments und den beabsichtigten Inhalt vor. Dann beantworten wir gemeinsam mehrere Fragen:- Wer sind die Leser dieses Dokuments? Welche Lesergruppe sollen angesprochen werden?
- Welche Hauptbotschaft soll das Dokument vermitteln?
- Was sollen die Leser lernen und an was sollen sie sich erinnern?
- Welche andere, unbeabsichtigten Lesergruppen gibt es, zum Beispiel Konkurrenten?
- Welche vielleicht vertrauliche Information soll unbeabsichtigten Lesern vorenthalten werden?
- Welche sind die Koautoren und was tragen sie zum Schreiben bei?
- Welche Termine und Verzögerungen müssen berücksichtigt werden?
Nach diesem Gespräch bereite ich einen Entwurf in Form einer Kurzfassung (Abstract) und einer erweiterten Zusammenfassung von etwa 250 bis 400 Worten vor und liefere einen Vorschlag für den Inhalt und Aufbau des Dokuments in Form eines Inhaltsverzeichnisses.
Der Haupt- oder Korrespondenzautor erhält beide Entwurfe (Kurzfassung und Inhaltsverzeichnis) innerhalb einer Woche nach dem Gespräch zur Einsicht und für Korrekturen.
Schritt 2: Gespräch mit Korrespondenzautor und den beitragenden Mitautoren; Inhalt auf zweiter Ebene
Der zweite Schritt schließt den führenden Autor und die beitragenden Mitautoren ein. Sie liefern ihre Änderungen zum vorgeschlagenen Inhalt auf oberster Ebene (Inhaltsverzeichnis). Ich treffe sie zu einem vertiefenden Gespräch über den Inhalt ihrer jeweiligen Beiträge/Kapitel. Bei dieser Gelegenheit geben die beitragenden Mitautoren an, welche Abbildungen oder Formeln/Gleichungen sie in das Dokument einbringen wollen. Sie werden diese Abbildungen oder Formeln später während der Erstellung des Dokuments nach ihren Wünschen liefern. Die Mitautoren bestimmen auch die Reihenfolge, in der ich ihre Beiträge schreiben soll.Nach diesem Gespräch bereite ich einen Vorschlag für den Inhalt auf zweiter Ebene vor, der den Abschnitten in jedem Kapitel entspricht. Diese Abschnitte geben die Ideen des Dokuments in logischer Reihenfolge wieder. Der Inhalt auf zweiter Ebene zeigt auch die Stellen an, wo Abbildungen, Tabellen oder Formeln eingefügt werden. Der Inhalt auf zweiter Ebene hat die Form einer nummerierten Liste in zwei Spalten; sie erstreckt sich normalerweise über ein bis zwei Seiten.
Ich liefere dem Hauptautor diesen Inhalt auf zweiter Ebene innerhalb einer Woche nach unserem Gespräch. Der Hauptautor regelt die Bearbeitung der Inhalte mit seinen Mitautoren. Gemeinsam lesen und korrigieren sie den Inhalt auf zweiter Ebene, um besser ihren Gedankengang und all ihre Dokumentationspläne darzustellen. Die Mitautoren können entscheiden, ob sie den ersten Entwurf ihrer Beiträge selbst schreiben wollen oder ob sie es vorziehen, dass ich den ersten Entwurf schreibe.
Schritt 3: Verfassen der einzelnen Kapitel
Der dritte Schritt ist das eigentliche Schreiben, Kapitel nach Kapitel. Ich schreibe die Kapitel in der Reihenfolge, wie die Autoren mir diese gegeben haben. Allerdings erstelle ich das Kapitel „Einführung“ erst, nachdem alle anderen Kapitel als Erstentwurf geschrieben worden sind. Ich werde die Punkte des Inhaltes auf zweiter Ebene (nummerierte Liste) als Untertitel vor jedem Abschnitt einfügen, um auf diese Weise die Korrekturarbeit zu vereinfachen. Ich füge die Abbildungen, Tabellen und Formeln in den Text ein, soweit die Autoren sie eingereicht haben. Ich werde aber keine eigenen Abbildungen und Tabellen erstellen.Jedes Kapitel wird ein bis zwei Seiten lang sein. Ich liefere den ersten Entwurf jedes Kapitels in hinreichend ausgereifter Form dem führenden Autor und dem verantwortlichen Mitautor bei etwa einem Kapitel pro Woche. Alle Mitautoren sind dann selbst verantwortlich, die Kapitel zu lesen, zu korrigieren und sie ihrem eigenen Schreibstil anzupassen. Sie sollten auch selbst Abbildungen, Tabellen und Formeln in den Text einfügen, wenn sie diese nicht vorher eingereicht haben.
Schritt 4: Zusammenstellung des endgültigen Dokuments
Der vierte und letzte Schritt ist die Zusammenstellung des endgültigen Dokuments. Dieser Schritt stellt sicher, dass das gesamte Dokument konsistent in Inhalt und Stil für alle Mitautoren ist. Dieser Schritt kann auch die Umwandlung in ein Format enthalten, das vom Verleger verlangt wird.Abschließende Zusammenfassung
Ich biete meine Hilfe zum Verfassen technischer Dokumente in Form eines Erstentwurfs an. Der Arbeitsaufwand unterteilt sich dabei in mehrere Schritte, die nach Vorgaben der Autoren durchgeführt werden. Teile der einzelnen Schritte (ab Level 2) können auch von den Autoren selbst übernommen werden. Sie werden von mir zu einem einheitlichen Dokument zusammengeführt. Neben guter deutscher Sprache biete ich vertieftes Wissen und Verständnis von wissenschaftlichem und technologischem Inhalt technischer Dokumente an. In diesem Zusammenhang werde ich unverbindlich Empfehlungen und werde ich unverbindlich Empfehlungen und Vorschläge zur Formulierung / Ausdrucksweise des technischen Inhalts anbieten. Ich werde auch empfehlen, besonders schwierige Kapitel oder Abschnitte in geeigneten Anhängen getrennt voneinander vorzustellen.
Jeder Schritt im Schreiben des Erstentwurfs benötigt eine Woche Arbeitszeit. Sollten die Auftraggeber eine Arbeit in einer kürzeren Zeitspanne als eine Woche benötigen, werde ich sie gegen einen Aufpreis gern berücksichtigen; dieser Aufpreis wird für jeden Fall und je nach Aufwand getrennt verhandelt.
Ferner biete ich an, die erarbeiteten Texte/Kapitel zu einem Dokument zusammenzufügen und das von den Autoren finalisierte Dokument im Anschluss in das Englische oder Französische gegen 50% Mehrkosten des Dokuments für jede Sprache zu übersetzen. Diese Möglichkeit erlaubt den Auftraggebern, internationale Leser und Kunden in ihrer eigenen, gewohnten Sprache anzusprechen.
Alle Rechte und Verantwortungen an dem Inhalt des Dokuments, sowie Urheberrechte oder auch Fragen der Vertraulichkeit liegen bei dem Auftraggeber bzw. dem Korrespondenzautor oder einem Verantwortlichen seiner Wahl.