{"meta":{"title":"Schreiben von zu übersetzenden Inhalten","intro":"Unsere Dokumentation wird in mehrere Sprachen übersetzt. Die Vorgehensweise beim Schreiben der englischsprachigen Dokumentation kann die Qualität dieser Übersetzungen erheblich verbessern.","product":"Mitwirken an den GitHub-Docs","breadcrumbs":[{"href":"/de/contributing","title":"Mitwirken an den GitHub-Docs"},{"href":"/de/contributing/writing-for-github-docs","title":"Schreiben für GitHub Dokumente"},{"href":"/de/contributing/writing-for-github-docs/writing-content-to-be-translated","title":"Inhalte zum Übersetzen schreiben"}],"documentType":"article"},"body":"# Schreiben von zu übersetzenden Inhalten\n\nUnsere Dokumentation wird in mehrere Sprachen übersetzt. Die Vorgehensweise beim Schreiben der englischsprachigen Dokumentation kann die Qualität dieser Übersetzungen erheblich verbessern.\n\n## Informationen zum Schreiben übersetzungsfreundlicher Inhalten\n\nVerwende die folgenden Richtlinien, um sicherzustellen, dass die von dir erstellten Inhalte erfolgreich übersetzt werden können. Weitere Informationen findest du unter [Styleguide](/de/contributing/style-guide-and-content-model/style-guide).\n\n* Verwende generische Beispiele, die von den meisten Menschen verstanden werden können.\n* Vermeide kontroverse oder für eine Gruppe kulturspezifische Beispiele.\n* Schreibe im Aktiv.\n* Schreibe einfache, kurze und leicht verständliche Sätze.\n* Vermeide die Verwendung von zu vielen Pronomen, durch die Texte undeutlich werden können.\n* Vermeide die Verwendung von Jargon und Witzen.\n* Vermeide negative Sätze.\n* Verwende nach Möglichkeit branchenübliche Abkürzungen, und erläutere eigene Abkürzungen.\n* Verwende den Indikativ.\n* Eliminiere redundante und wortreiche Wendungen.\n* Vermeide die übermäßige Verwendung aneinandergereihter Wörter (zusammengesetzte Substantive). Für Übersetzer\\*innen könnte nicht immer klar erkennbar sein, welches Nomen verändert wird.\n* Vermeide unsichtbare Plurale, bei denen nicht klar ist, ob das erste Substantiv im Singular oder Plural stehen soll.\n* Vermeide Nominalisierungen.\n* Vermeide mehrdeutige Modalverben zu verwenden.\n* Vermeide geschlechtsspezifische Wörter.\n* Vermeide Präpositionalphrasen.\n* Vermeide unspezifische Nomen und Pronomen (vage Satzsubjekte).\n* Beschränke die Verwendung von Inlinelinks auf ein Minimum. Falls Inlinelinks erforderlich sind, stelle ihnen einen Satz wie „Weitere Informationen findest du unter ‚Linkname‘“ voran. Alternativ kannst du relevante Links zu einem Abschnitt „Weitere Informationen“ am Ende des Artikels hinzufügen.\n\n## Beispiele\n\nDieser Abschnitt enthält Beispiele zum Befolgen unserer Richtlinien für das Schreiben einer übersetzungsfreundlichen Dokumentation.\n\n### Vermeiden länderspezifischer Informationen\n\nVermeide beispielsweise 0800er-Nummern und länderspezifische Adressen. Falls erforderlich, gib an, für welche Länder die Informationen gelten.\n\n### Vermeiden der Verwendung aneinandergereihter Wörter (zusammengesetzte Substantive)\n\nViele aneinandergereihte Wörter können zu falschen Übersetzungen führen, da nicht einfach erkennbar ist, was sich worauf bezieht. Verwende beispielsweise „Standardquelleinstellungen für das öffentliches Repository“ statt „öffentliche Repositorystandardquelleneinstellungen“.\n\n### Unsichtbare Plurale vermeiden\n\nBei der Verwendung des Begriffs „Dateiabruf“ ist es unklar, ob es sich dabei um eine oder mehrere Dateien handelt. Sorge für mehr Kontext, um Mehrdeutigkeiten zu vermeiden. Im genannten Beispiel kannst du „Abrufen aller Dateien“ oder „Abrufen der source.md-Datei“ verwenden.\n\n### Vermeiden von Nominalisierungen\n\nVerwende beispielsweise „abschließen“ statt „zum Abschluss kommen“.\n\n### Vermeide Verwendung mehrdeutiger Modalverben.\n\nVermeide die Verwendung von Wörtern wie „dürfte“ oder „könnte“. Verwende klare Formulierungen, um Mehrdeutigkeiten zu vermeiden.\n\n### Vermeiden von Präpositionalphrasen\n\nSchreibe direkter, anstatt „nach mehreren Versuchen“ oder „gemäß dem Repositoryprotokoll“ zu schreiben. Schreibe beispielsweise „nach drei Versuchen“.\n\n### Vermeiden unklarer Nomen und Pronomen\n\nBei der Verwendung unklarer Nomen und Pronomen ist es nicht immer klar, auf wen oder was du dich beziehst, insbesondere wenn diese Inhalte übersetzt werden müssen. Zum Beispiel haben Maintainer\\*innen und Mitwirkende Zugriff auf Dateien und Kommentare. Im Pull Request nehmen sie Änderungen daran vor.“ In diesem Satz ist nicht klar, ob die Änderungen an der Datei oder den Kommentaren vorgenommen werden. Wenn ein Pronomen über mehr als ein Bezugswort verfügt, kannst du entweder den Satz umformulieren, um das Bezugswort klar zu machen, oder das Pronomen durch ein Nomen ersetzen, um Mehrdeutigkeit zu vermeiden.\n\n### Beschränke die Verwendung von Inlinelinks auf ein Minimum.\n\nBefolge beim Einfügen von Links nach Möglichkeit unseren Styleguide. Verwende beispielsweise nicht den folgenden Satz:\n\n```markdown\nRead [more about OAuth2.](/apps/building-integrations/setting-up-and-registering-oauth-apps/) Note that OAuth2 tokens can be [acquired programmatically](/rest/reference/oauth-authorizations/#create-a-new-authorization), for applications that are not websites.\n```\n\nVerwende stattdessen diesen Satz:\n\n```markdown\nOAuth2 tokens can be acquired programmatically for applications that are not websites. For more information, see [AUTOTITLE](apps/building-integrations/setting-up-and-registering-oauth-apps/) and [Create a new authorization](/rest/reference/oauth-authorizations/#create-a-new-authorization).\n```"}