{"meta":{"title":"Inhalt eines GitHub Docs-Artikels","intro":"Jeder Artikel enthält einige Standardelemente und kann konditionale oder optionale Elemente enthalten. Wir verwenden auch eine Standardreihenfolge für Inhalte innerhalb eines Artikels.","product":"Mitwirken an den GitHub-Docs","breadcrumbs":[{"href":"/de/contributing","title":"Mitwirken an den GitHub-Docs"},{"href":"/de/contributing/style-guide-and-content-model","title":"Stilrichtlinien und Inhaltsmodell"},{"href":"/de/contributing/style-guide-and-content-model/contents-of-a-github-docs-article","title":"Inhalt eines Artikels"}],"documentType":"article"},"body":"# Inhalt eines GitHub Docs-Artikels\n\nJeder Artikel enthält einige Standardelemente und kann konditionale oder optionale Elemente enthalten. Wir verwenden auch eine Standardreihenfolge für Inhalte innerhalb eines Artikels.\n\n## Informationen zur Struktur eines Artikels\n\nInnerhalb eines Artikels gibt es eine Standardreihenfolge der Inhaltsabschnitte. Jeder Artikel enthält erforderliche Elemente. Artikel enthalten auch konditionale und optionale Elemente, die beim Entwurf oder bei der Erstellung von Inhalten beschrieben werden. Die folgenden Richtlinien bieten weitere Informationen.\n\n![Screenshot eines Artikels mit gekennzeichnetem Titel, Einführung, Berechtigungen, Produktaufruf, konzeptionellem Abschnitt, prozeduralem Abschnitt und Inhaltsverzeichnis.](/assets/images/contributing/illustration-of-article-contents.png)\n\n## Titel\n\nTitel beschreiben vollständig, worum es auf einer Seite geht und was jemand durch das Lesen der Seite lernen wird.\n\nDie Titel können herausfordernd sein. Verwenden Sie diese allgemeinen Richtlinien, um klare, hilfreiche und beschreibende Titel zu formulieren. Die Richtlinien für jeden Inhaltstyp in diesem Artikel enthalten spezifischere Titelregeln.\n\n### Titel für alle Inhaltstypen\n\n* Titel beschreiben eindeutig, worum es auf einer Seite geht. Sie sind beschreibend und spezifisch.\n  * Verwenden Sie beispielsweise „Durchsuchen von Aktionen im Workflow-Editor“.\n  * Verwenden Sie das „Beispiel für die Konfiguration eines Codespace“.\n  * Vermeiden Sie die Verwendung der Seitenleiste des Workflow-Editors.\n  * Vermeiden Sie Titel wie „Beispiel“.\n* Für Titel gelten strenge Längenbeschränkungen, sodass sie leicht zu verstehen sind (und auf der Website einfacher gerendert werden können):\n  * Kategorietitel: 67 Zeichen und [`shortTitle`](https://github.com/github/docs/tree/main/content#shorttitle) 26 Zeichen\n  * Titel für zugehörige Themen: 63 Zeichen und [`shortTitle`](https://github.com/github/docs/tree/main/content#shorttitle) 29 Zeichen\n  * Artikeltitel: 80 Zeichen (nach Möglichkeit 60 Zeichen), und [`shortTitle`](https://github.com/github/docs/tree/main/content#shorttitle) 30 Zeichen (idealerweise 20 bis 25 Zeichen).\n* Die Groß- und Kleinschreibung in Titeln entspricht dem normalen Text.\n  * Verwenden Sie 'Ändern einer Commit-Nachricht'\n  * Vermeiden Sie: „Eine Commit-Nachricht ändern“\n* Titel sind für einen Inhaltstyp konsistent. Sehen Sie sich die spezifischen Richtlinien für jeden Inhaltstyp an.\n* Titel sind allgemein genug, um bei Produktänderungen skaliert werden zu können, den gesamten Inhalt innerhalb des Artikels widerzuspiegeln oder Inhalte zu mehreren Produkten zu enthalten.\n  * Verwendung von: „Abrechnungspläne von GitHub“\n  * Vermeiden Sie „Abrechnungspläne für Benutzer- und Organisationskonten“.\n* Für Titel wird eine konsistente Terminologie verwendet.\n  * Entwicklen und befolgen Sie Muster innerhalb einer Kategorie oder zu ähnlichen Themen.\n* Für Titel wird Terminologie aus dem Produkt selbst verwendet.\n* Formulieren Sie den Titel und die Einführung in einem Schritt.\n  * Verwenden Sie die Einführung, um die im Titel vorgestellten Ideen weiter auszuführen.\n  * Weitere Informationen finden Sie in der Anleitung zu [Einführungen](#intro).\n* Wenn Sie Probleme beim Formulieren eines Titels haben, berücksichtigen Sie den Inhaltstyp. Manchmal deuten Probleme bei der Auswahl eines Titels darauf hin, dass ein anderer Inhaltstyp besser geeignet ist.\n* Überlegen Sie, wie der Titel in den Suchergebnissen für mehrere Produkte angezeigt wird.\n  * Welche spezifischen Wörter müssen wir in den Titel oder die Einführung aufnehmen, damit es nicht mit Inhalten zu einem anderen Produkt verwechselt wird?\n* Überlegen Sie, wie der Titel in der Produktion aussehen wird.\n\n## Einführung\n\nJede Seite und jeder Artikel enthält eine Einführung, die beschreibt, worum es geht. Der Text, den wir für Einführungen verwenden, wird auch in Suchergebnissen angezeigt und macht sie für SEO wichtig.\n\n### So schreiben Sie eine Einführung\n\n* Intros sollten prägnant sein, idealerweise ein Satz lang.\n* Einführungen helfen Menschen dabei, herauszufinden, ob sie am richtigen Ort für ihre Bedürfnisse sind. Informieren Sie den Benutzer darüber, welchen Mehrwert Sie bieten, indem Sie Wörter verwenden, die er verwenden und nach denen er suchen würde.\n* Einführungen sind auch eine Einladung, weiterzulesen. Eine gute Einführung versichert dem Leser, dass ihre Zeit gut aufgewendet wird.\n* Wenn ein wichtiger Begriff ein verwandtes Akronym aufweist, das in der Regel an seiner Stelle verwendet wird, schließen Sie das Akronym in die Einführung ein. (Beispiel: Suchmaschinenoptimierung und SEO.)\n* Überprüfen Sie schließlich Ihre Einführung, um sicherzustellen, dass sie suchmaschinenfreundlich ist, indem Sie relevante Schlüsselwörter und Ausdrücke einschließen.\n\n## Berechtigungsaussagen\n\nJede Prozedur enthält Angaben zu Berechtigungen, die die Rolle erläutern, die zum Ausführen der in der Prozedur beschriebenen Aktion erforderlich ist. Dies hilft den Benutzer\\*innen zu verstehen, ob sie die Aufgabe abschließen können.\n\nGelegentlich ist es relevant, die erforderlichen Berechtigungen in konzeptionellen Inhalten zu erwähnen (insbesondere in eigenständigen konzeptuellen Artikeln). Stellt sicher, dass die Angaben zu Berechtigungen auch in relevante Verfahren eingefügt werden (oder einen längeren Artikel schreiben, der den gesamten Inhalt kombiniert).\n\n### Wie man eine Berechtigungserklärung verfasst\n\n* Wenn eine einzelne Berechtigungsgruppe für alle Prozeduren in einem Artikel gilt, verwende die [permissions-Frontmatter](https://github.com/github/docs/tree/main/content#permissions).\n* Wenn ein Artikel mehrere Prozeduren enthält und unterschiedliche Berechtigungen gelten, fügen Sie vor jeder Prozedur unter jeder relevanten Überschrift Angaben zu Berechtigungen ein.\n* Fügen Sie keine Angaben zu Berechtigungen in die Einführung eines Artikels ein.\n* Es gibt Rollen auf verschiedenen Ebenen. Beziehen Sie sich nur auf die Rolle, die sich auf derselben Ebene wie die Aktion befindet. Beispielsweise benötigen Sie Administratorzugriff auf ein Repository (Rolle auf Repositoryebene), um geschützte Branches zu konfigurieren. Sie können Administratorzugriff auf ein Repository erhalten, indem Sie Organisationsbesitzer\\*in bist (Rolle auf Organisationsebene), aber die Rolle auf Repositoryebene bestimmt letztendlich, ob die Aktion möglich ist. Deshalb ist das die einzige Rolle, die in den Angaben zu Berechtigungen erwähnt werden sollte.\n* Sprache, die in Angaben zu Berechtigungen verwendet werden soll:\n  * Personen mit \\[KONTOROLLE].\n  * \\[KONTOROLLE] kann \\[AKTION].\n  * Personen mit \\[FEATUREROLLE]-Zugriffsberechtigungen für \\[FEATURE] können \\[AKTION].\n  * Vermeiden Sie Formulierungen wie „\\[KONTOROLLE] und Personen mit \\[FEATUREROLLE]-Zugriff für \\[FEATURE] können \\[AKTION]“.\n\nWeitere Informationen zum Formatieren von Berechtigungsanweisungen findest du unter [Stil-Leitfaden](/de/contributing/style-guide-and-content-model/style-guide#permission-statements-and-product-callouts).\n\n## Produktcallouts\n\nVerwenden Sie den Produktcallout, wenn ein Feature nur in bestimmten Produkten verfügbar ist und diese Verfügbarkeit nicht allein durch die Versionsverwaltung vermittelt werden kann. Wenn beispielsweise ein Feature für GHEC und GHES verfügbar ist, können Sie Inhalte zum Feature nur für GHEC und GHES versionieren. Wenn ein Feature für Pro, Team, GHEC und GHES (aber nicht für Free) verfügbar ist, verwenden Sie einen Produktcallout, um diese Verfügbarkeit zu vermitteln.\n\nAlle Produktcallouts werden als wiederverwendbare Elemente in [`gated-features`](https://github.com/github/docs/tree/main/data/reusables/gated-features) gespeichert und für relevante Artikel im YAML-Frontmatter hinzugefügt.\n\n### Schreiben von Produktcallouts\n\n* Produktcallouts folgen einem strengen Format, durch das das Feature und die darin enthaltenen Produkte eindeutig angegeben werden.\n* Produktcallouts können Links zu Artikeln enthalten, die Benutzern direkt helfen, zu verstehen, wer die Funktion nutzen kann. Diese Links können Inlinelinks zu den spezifischen Produkten oder GitHub Plänen sein, die erforderlich sind.\n* Beispiele:\n  * \\[Featurename] ist in \\[Produkt(e)] verfügbar.\n  * \\[Featurename] ist in öffentlichen Repositorys mit \\[kostenlose Produkte] und in öffentlichen und privaten Repositorys mit \\[kostenpflichtige Produkte] verfügbar.\n\n### Beispiele für Artikel mit Produkthinweisen\n\nÜberprüfen Sie die Quelldateien und `gated-features`, um zu sehen, wie Quellinhalte geschrieben werden.\n\n* [Verwalten einer Branchschutzregel](/de/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule)\n\n## Werkzeugwechsler\n\nEinige Artikel enthalten Inhalte, die sich je nach dem für eine Aufgabe verwendeten Tool unterscheiden, wie zum Beispiel GitHub CLI oder GitHub Desktop. Bei den meisten Inhalten sind dieselben konzeptionellen oder prozeduralen Informationen für mehrere Tools gültig. Wenn die einzige Möglichkeit, Informationen deutlich zu vermitteln, darin besteht, Inhalte nach Tool zu unterscheiden, verwende den Toolumschalter. Verwenden Sie den Toolumschalter nicht, um lediglich Beispiele in verschiedenen Sprachen anzuzeigen. Verwenden Sie den Toolumschalter nur, wenn sich die Aufgaben oder Konzepte in Abhängigkeit des verwendeten Tools ändern. Weitere Informationen finden Sie unter [Erstellen von Toolumschaltern in Artikeln](/de/contributing/writing-for-github-docs/creating-tool-switchers-in-articles).\n\n## Inhaltsverzeichnis\n\nInhaltsverzeichnisse werden automatisch generiert. Weitere Informationen finden Sie unter [Automatisch generierte Kurzverzeichnisse](https://github.com/github/docs/tree/main/content#autogenerated-mini-tocs).\n\n## Konzeptionelle Inhalte\n\nKonzeptionelle Inhalte helfen dabei, ein Thema zu verstehen oder mehr darüber zu erfahren. Weitere Informationen findest du unter [Inhaltstyp „Konzepte“](/de/contributing/style-guide-and-content-model/concepts-content-type) im Inhaltsmodell.\n\n## Referenzielle Inhalte\n\nReferenzielle Inhalte bieten strukturierte Informationen im Zusammenhang mit der aktiven Verwendung eines Produkts oder Features. Weitere Informationen findest du unter [Referenzinhaltstyp](/de/contributing/style-guide-and-content-model/reference-content-type) im Inhaltsmodell.\n\n## Voraussetzungen\n\nVoraussetzungen sind Informationen, die Personen kennen müssen, bevor sie mit einer Prozedur fortfahren, damit sie vor Beginn der Aufgabe alle erforderlichen Komponenten vorbereiten können.\n\n### Formulieren von Voraussetzungen\n\n* Nenne die Voraussetzungen unmittelbar vor den nummerierten Schritten einer Prozedur.\n* Sie können eine Liste, einen Satz oder einen Absatz verwenden, um die Voraussetzungen zu erläutern.\n* In den folgenden Fällen können Sie auch einen separaten Abschnitt mit den Voraussetzungen verwenden:\n  * Die Informationen zu den Voraussetzungen sind sehr wichtig und sollten nicht übersehen werden.\n  * Es gibt mehrere Voraussetzungen.\n* Um wichtige Informationen zu Datenverlust oder destruktiven Aktionen zu wiederholen oder hervorzuheben, können Sie auch eine Warnung oder einen Gefahrenhinweis verwenden, um eine Voraussetzung zu vermitteln.\n\n### Titelrichtlinien für Voraussetzungen\n\n* Bei einem separaten Abschnitt, verwenden Sie eine Überschrift namens `Prerequisites`.\n\n### Beispiele für Artikel mit Abschnitten zu Voraussetzungen\n\n* [Installieren von GitHub Enterprise Server auf AWS](/de/enterprise-server@3.22/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws)\n* [Subdomain-Isolation aktivieren](/de/enterprise-server@3.22/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-subdomain-isolation)\n\n## Anleitungen\n\nAnleitungen helfen Menschen, Aufgaben zu erledigen. Weitere Informationen findest du unter [Inhaltstyp Anleitung](/de/contributing/style-guide-and-content-model/how-to-content-type) im Inhaltsmodell.\n\n## Inhalte zur Problembehandlung\n\nInhalte zur Problembehandlung helfen Benutzer\\*innen dabei, Fehler zu vermeiden oder zu beheben. Weitere Informationen findest du unter [Inhaltstyp zur Problembehandlung](/de/contributing/style-guide-and-content-model/troubleshooting-content-type) im Inhaltsmodell.\n\n## Nächste Schritte\n\nWenn ein Artikel einen Schritt in einem größeren Prozess beschreibt oder über einen logischen nächsten Schritt verfügt, den die meisten Personen ausführen möchten, schließe einen Abschnitt mit den nächsten Schritten ein. Sie können Personen mit Artikeln oder anderen GitHub Ressourcen verknüpfen.\n\n### Beispiele für Abschnitte der nächsten Schritte\n\n```markdown\n## Next steps\n\n- You can monitor self-hosted runners and troubleshoot common issues. See \"Monitoring and troubleshooting self hosted runners.\"\n\n- GitHub recommends that you review security considerations for self-hosted runner machines. See \"Security hardening for GitHub Actions.\"\n```\n\nIn diesem Beispiel aus [Erste Schritte mit selbstgehosteten Runnern für Ihr Unternehmen](/de/enterprise-cloud@latest/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise#next-steps) enthält der Abschnitt „Nächste Schritte“ Links zu Prozeduren, die durchgeführt werden müssen, nachdem man mit der Verwendung des im Artikel beschriebenen Features begonnen hat.\n\n```markdown\n## Next steps\n\nAfter your enterprise account is created, we recommend learning more about how enterprise accounts work and configuring settings and policies. Follow the \"Get started with your enterprise account\" learning path.\n```\n\nIn diesem Beispiel aus [Erstellen eines Unternehmenskontos](/de/enterprise-cloud@latest/admin/managing-your-enterprise-account/creating-an-enterprise-account#next-steps) wird der nächste Schritt mit dem Ort verknüpft, an dem die meisten Personen, die gerade die Erstellung einer Enterprise-Konto abgeschlossen haben, wahrscheinlich als Nächstes fortfahren möchten.\n\n## Weiterführende Lektüre\n\nWenn es zusätzliche Artikel gibt, die Personen bei der Durchführung ihrer Aufgabe unterstützen oder ihnen lehren, das im aktuellen Artikel beschriebene Thema zu verwenden, füge sie in einen weiteren Leseabschnitt ein. Füge nur Links zu Artikeln hinzu, die noch nicht im Inhalt des Artikels verknüpft wurden.\n\nFüge nur Links hinzu, die Personen bei der betreffenden Aufgabe oder dem Thema unterstützen. Es ist besser, fokussiert zu sein und Personen wertvolle Ressourcen zur Verfügung zu stellen, als ihnen jeden möglichen Link anzubieten.\n\nFormatieren Sie die Abschnitte „Weiterführende Informationen“ mithilfe von ungeordneten Listen. Informationen zum Erstellen von Links findest du unter [Stil-Leitfaden](/de/contributing/style-guide-and-content-model/style-guide#links).\n\n### Titel und Format für weiterführende Literaturabschnitte\n\n```markdown\n## Further reading\n- [Article title](article-URL)\n- [External resource title](external-resource-URL) in External Resource Name\n```"}