Auffindbar machen von Inhalten in der Suche

Halten Sie sich an diese bewährten SEO-Methoden, damit Benutzer die Dokumentation zu GitHub mithilfe von Suchmaschinen einfacher finden können.

In diesem Artikel

Informationen zur Suchmaschinenoptimierung (SEO)

Die Suchmaschinenoptimierung (SEO) ist eine Methode zur Verbesserung der Sichtbarkeit von Webinhalten in den Ergebnissen von Suchmaschinen wie Google und Bing. Die Google-Suche ist der wichtigste Referrer auf GitHub Docs und der häufigste Einstiegspunkt für unsere Benutzer.

Wir können unsere Inhalte im Hinblick auf die Verbesserung der SEO planen und schreiben. Eine bessere SEO verbessert die Erfahrung der Personen, die nach Dokumentation suchen, denn sie erhöht die Wahrscheinlichkeit, die anhand der bevorzugten Suchbegriffe gesuchten Informationen aufzufinden.

Bewährte Methoden für die SEO von Inhalten

Für eine gute SEO muss man Inhalte für bestimmte Zielgruppen planen und auf die Wörter achten, die sie für die Suche verwenden. Halten Sie sich an diese bewährten Methoden, um die SEO eines Artikels zu verbessern.

Eine Zielgruppe auswählen

Verstehen Sie die spezifische Zielgruppe für die Inhalte und schreiben Sie für sie: Entwickler, Administratoren oder Code-Anfänger. Das hilft Ihnen bei Folgendem:

  • Benutzen Sie Wörter, die Ihre Leser verwenden.
  • Gestalten Sie Inhalte relevant für ihre Bedürfnisse und Aufgaben.
  • Nehmen Sie die richtige Menge an Kontext und Hintergrundinformationen auf.

Auf Suchabsicht reagieren

Gestalten Sie Inhalte im Hinblick auf die Suchabsicht: die Aufgabe, die Frage oder das Problem, die oder das ein Mitglied der Zielgruppe dazu veranlasst, online nach Informationen zu suchen.

  • Erforschen Sie die Suchabsicht. Analysieren Sie z. B. die Ergebnisseiten von Suchmaschinen (SERPs) auf entsprechende Abfragen.
  • Versuchen Sie, die Anforderungen der Benutzer nachzuvollziehen. Verwenden Sie mehrere Quellen wie Kundenfeedback, Benutzerbefragungen und Metriken.

Deutliche Sprache benutzen

Halte dich an die Anleitungen in Bewährte Methoden für GitHub-Dokumente:

  • Stellen Sie sicher, dass jeder Artikel über ein klares, eigenständiges Thema hat.
  • Bringen Sie Inhalte mit höherer Priorität in einem Artikel an erster Stelle unter.
  • Strukturieren Sie Artikeln mit klaren Überschriften.
  • Bearbeite Inhalte auf Konsistenz gemäß Styleguide.

Schlüsselwörter aufnehmen

Nehmen Sie Schlüsselwörter oder die gängigsten von Ihrer Zielgruppe verwendeten Suchbegriffe in den Seitentext und in Metadaten auf. Wenn Sie z. B. über „Abrechnung“ schreiben, ihre Zielgruppe jedoch vorwiegend „Kosten“ und „Zahlung“ verwendet, sollten Sie stattdessen diese Begriffe benutzen.

Sowohl Google als auch Bing bieten Tools zur Schlüsselwort-Recherche an, mit deren Hilfe Sie relevante Schlüsselwörter erforschen können. Das Dokumentationsteam konsultiert auch Daten der Google Search Console, um zu verstehen, welche Suchbegriffe zu Seiten auf GitHub Docs führen.

Metadaten aufnehmen

Verwenden Sie vollständige Metadaten in der Titelei. Informationen zu den verfügbaren Werten findest du unter Verwenden einer YAML-Titelei.

In GitHub Docs wird das intro-Element als Unterüberschrift auf der Seite angezeigt und dient als HTML-Metadatenbeschreibung. Der Titel des Artikels dient als HTML-Seitentitel. Gehen Sie für eine gute SEO folgendermaßen vor:

  • Schreiben Sie den Titel und intro so, dass sie ergänzend und reich an Schlüsselwörtern sind. Überlegen Sie, wie sie bei der Recherche wiedergegeben werden.
  • Fügen Sie allen Bildern einen schlüsselwortreichen alternativen Text bei, der von Suchmaschinen auch als Metadaten verwendet wird. Siehe Alternativer Text im Styleguide für GitHub Docs.

Verlinke sparsam auf andere für Aufgaben relevanten Seiten auf GitHub Docs und qualitativ hochwertige andere Websites gemäß Links im Styleguide für GitHub Docs.

Stellen Sie mit sorgfältigen Umleitungen sicher, dass eingehende Links nicht unterbrochen werden.

Genauigkeit wahren

Stellen Sie sicher, dass Inhalte hinsichtlich Fakten, Rechtschreibung und Stil frei von Fehlern sind. Überwachen Sie Inhalte regelmäßig, um Fehler wie fehlerhafte Links zu beheben und nicht benötigte Inhalte zu entfernen. Weitere Informationen findest du unter Konfigurieren von Umleitungen.