Ein Artikel kann als relevant für ein oder mehrere Themen definiert werden, indem die Themen im Frontmatter des Artikels aufgeführt werden. Zum Beispiel:
---
title: "Managing branches in your repository"
topics:
- "GitHub"
- "Git"
- "Repositories"
---
Weitere Informationen zum Hinzufügen von Themen zu einem Artikel finden Sie unter „Verwenden einer YAML-Titelei“. Eine Liste aller zulässigen Themen finden Sie unter allowed-topics
.
Themen für alle Inhaltstypen
- Verwenden Sie Nomen für die Themen.
- Themen helfen dabei, Inhalte sinnvoll zu gruppieren.
- Verwenden Sie nach Möglichkeit spezifischere Themen, die relevant sind, und nicht nur allgemeine Themen. Beispielsweise sollte
REST
oderGraphQL
statt nurAPI
verwendet werden. - Stellen Sie sicher, dass Themen in ähnlichen Artikeln konsistent sind, damit den Personen, die nach einem Thema filtern, alle relevanten Artikel angezeigt werden. Beispielsweise sollten alle Artikel zu CI das
CI
-Thema sowie spezifischere Themen enthalten. - Vermeiden Sie mehrdeutige Themen. Beispielsweise handelt es sich bei
Actions
um kein nützliches Thema innerhalb des Actions-Produkts, da sich dies auf das Produkt GitHub Actions oder das Produktelement beziehen könnte, das als Aktion bezeichnet wird.
- Verwenden Sie nach Möglichkeit spezifischere Themen, die relevant sind, und nicht nur allgemeine Themen. Beispielsweise sollte
- Themen bieten einen Mehrwert und replizieren nicht den Titel, den Typ oder die Kategorie des Artikels.
- Beispielsweise bietet
Actions
innerhalb des Actions-Produkts keinen Mehrwert, da Benutzer*innen in diesem Abschnitt der Dokumentation bereits wissen, dass sie die Actions-Dokumentation lesen.
- Beispielsweise bietet
- Verwenden Sie
Fundamentals
für Artikel, die sich auf die Kernkonzepte eines Produktbereichs beziehen.- Empfohlen wird beispielsweise die Verwendung von
Fundamentals
in einem Artikel wie „Einführung in GitHub Actions“. - Nicht empfohlen wird beispielsweise die Verwendung von
Actions
in einem Artikel wie „Einführung in GitHub Actions“.
- Empfohlen wird beispielsweise die Verwendung von
- Allgemein anerkannte Abkürzungen können verwendet werden, aber undeutliche oder mehrdeutige Abkürzungen sollten vermieden werden.
- Verwenden Sie
CI
anstelle vonContinuous integration
. - Vermeiden Sie die Verwendung von
AS
fürAdvanced Security
.
- Verwenden Sie
- Verwenden Sie die Kurzformen von GitHub-Produktnamen.
- Verwenden Sie
Actions
anstelle vonGitHub Actions
.
- Verwenden Sie
Checkliste für die Themenauswahl
Berücksichtigen Sie diese Fragen, um Themen für einen Artikel auszuwählen. Nicht jeder Artikel umfasst ein Thema für jedes Element in der Checkliste.
- Um welchen Feature- oder Produktbereich handelt es sich?
- Beispiel
Enterprise
: Handelt es sich im Artikel um ein ergänzendes Feature? (Es sei denn, der Produktname stimmt mit dem Featurenamen überein.) - Ein Beispiel:
Dependabot
- Beispiel
- Ist das Feature Teil eines eingeschränkten Programms?
- Ein Beispiel:
Advanced Security
- Ein Beispiel:
- Auf welches Element des Features oder Produkts bezieht sich der Artikel?
- Ein Beispiel:
Organizations
- Ein Beispiel:
- Wie lautet der allgemeine Zweck des Artikels?
- Ein Beispiel:
Permissions
- Ein Beispiel:
- Welche Programmiersprachen, Paket-Manager oder Ökosysteme werden im Artikel explizit behandelt? Fügen Sie diese Themen nur hinzu, wenn dies für die Filterung der Dokumentation einen Nutzen hat, nicht nur dann, wenn in einem Artikel unterstützte Sprachen, Paket-Manager oder Ökosysteme aufgeführt werden.
- Beispiel:
Ruby
- Beispiel: