Korrigieren & Einsenden

Korrekturen einreichen

Ihre ersten paar Änderungen am Handbuch werden Sie als Korrektur einreichen müssen, damit der Abschnitts-Besitzer sie überprüfen kann. Dies soll sicherstellen, dass wir ein Qualitäts-Benutzerhandbuch halten und dass Sie nicht versehentlich etwas Wesentliches kaputtmachen, bevor Sie mit dem System vertraut sind.

Um eine Korrektur einzureichen folgen Sie diesem Ablauf:

  1. Führen Sie alle von Ihnen gewünschten Änderungen durch.

  2. Erstellen Sie mit folgendem Befehl eine Korrekturdatei:

    svn diff > filename.diff

    Dies erzeugt eine einfache Textdatei, die angibt, welche Texte in Ihren Arbeitsdateien gegenüber dem zentralen Repository hinzugefügt, gelöscht oder geändert wurden.

    Wenn Sie Dateien erzeugt oder gelöscht haben, müssen Sie vor der Erstellung der Änderungsdatei svn add /path/to/file oder svn rm /path/to/file ausführen. Für eine Liste der betroffenen Dateien führen Sie svn status aus.

  3. Laden Sie die Korrekturdatei hier hoch. Wenn Sie bislang noch keinen Account haben, können Sie einen registrieren.

  4. Nach dem Hochladen der Korrekturdatei müssen Sie mit „Create a new Revision“ eine neue Revision erzeugen, damit Sie einen Titel und eine Beschreibung Ihrer Änderungen hinzufügen können.

  5. Bitte vergewissern Sie sich, dass das Dokumentationsprojekt im Tag-Feld eingetragen ist, um das Team von Ihrer Korrektur zu benachrichtigen. Sie können das Team auch über die Mailing-Liste kontaktieren, oder über Blender Chat.

  6. Sie werden Ihre Korrektur überprüfen und Sie auf mögliche Änderungen hinweisen, oder die Änderung übernehmen, falls sie akzeptiert wird.

Bemerkung

Wenn Ihre Korrektur Änderungen an oder zusätzliche Bilder beinhaltet, hängen Sie sie einfach an, wenn Sie die Revision erstellen.

Überschaubare Korrekturen werden meist sehr schnell akzeptiert. Wenn Sie daran gewöhnt sind, Änderungen zu machen und kein Feedback mehr benötigen, werden wir den Mittelsmann weglassen und Ihnen direkten Zugang zur Handbuchbearbeitung geben.

Direktes Einsenden (Commit)

Beim Einsenden wird keine Korrekturdatei erstellt, die Änderungen werden direkt an unser zentrales Repository geleitet.

Nun müssen Sie lediglich folgenden Befehl ausführen:

svn commit -m "This is what I did"

Wenn Sie den Parameter -m "Nachricht" weglassen, werden Sie aufgefordert, die Nachricht in einem Texteditor einzugeben.

Vergessen Sie nicht, immer svn update vor dem Übermitteln aufzurufen.

Bevor die Änderung übergeben wird, werden Sie nach Ihrem Benutzernamen (von developer.blender.org) und Passwort gefragt.

Ihre modifizierten Dateien werden in das zentrale Verzeichnis hochgeladen, sodass Andere damit arbeiten und weiter kollaborieren können. Einsendungen (Commits) können in der sog. Diffusion des Zentralverzeichnisses nachverfolgt werden. Kurz darauf werden Ihre Änderungen im Online-Handbuch sichtbar.