MDN Web Docs Repositories

MDN Web Docs ist ein komplexes Projekt mit vielen beweglichen Teilen. Es ist ratsam, sich mit den verschiedenen Repositories der Projekte vertraut zu machen. Dieses Dokument soll Ihnen helfen, die verschiedenen Repositories (Repos) zu finden, die Sie benötigen, wenn Sie zu verschiedenen Teilen des MDN Web Docs Projekts beitragen.

Repository-Stufen

Stufe 1

Der Code in diesen Repositories ist zentral für das MDN Web Docs-Projekt und läuft auf von Mozilla betriebenen Domains.

Ein Stufe-1-Projekt sollte mindestens 3 Mitglieder haben, darunter mindestens zwei mit Administratorrechten.

Stufe 2

Diese Repositories konzentrieren sich hauptsächlich auf unterstützende Inhalte wie Codebeispiele, den MDN Web Docs Lernbereich, Lokalisierung und Beispielprojekte. Beispiele beinhalten:

Ein Stufe-2-Projekt sollte mindestens 2 Mitglieder haben, darunter mindestens eines mit Administratorrechten.

Stufe 3

Diese Repositories werden für die Projektplanung, die Dokumentation des Projekts selbst und die Einbindung der Community verwendet. Beispiele beinhalten:

Ein Stufe-3-Projekt benötigt einen Admin.

Kern-Repos

  • Kerninhalt: https://github.com/mdn/content. Das wichtigste Repo für Inhalte von MDN Web Docs — hier wird der gesamte Kerninhalt in Englisch gespeichert, und hier machen Sie alle standardmäßigen Änderungen an den Seiteninhalten.
  • MDN Web Docs Plattform: https://github.com/mdn/yari. Hier wird die MDN Web Docs-Plattform gespeichert, und hier gehen Sie hin, wenn Sie Änderungen an unserer Seitenstruktur auf hoher Ebene oder der Rendering-Mechanik vornehmen möchten.
  • Daten zur Browser-Kompatibilität: https://github.com/mdn/browser-compat-data. Hier werden die Daten gespeichert, die verwendet werden, um die Tabellen zur Browser-Kompatibilität zu erstellen, die auf unseren Referenzseiten zu finden sind (Beispiel). Wenn Sie Informationen zur Browser-Kompatibilität von Web-Features haben — oder bereit und in der Lage sind, einige Recherchen und/oder Experimente durchzuführen — können Sie helfen, MDN's Daten zur Browser-Kompatibilität zu aktualisieren.
  • Interaktive Beispiele: https://github.com/mdn/interactive-examples. Dieses Repo speichert die Beispielcodeblöcke, die am Anfang vieler unserer Referenzseiten zu finden sind (Beispiel). Bearbeiten Sie diese Beispiele hier.
  • Bob aka Builder of Bits: https://github.com/mdn/bob Dieses Repo speichert den Rendering-Code, der die schönen editierbaren und kopierbaren Beispiele erzeugt, die am Anfang vieler unserer Referenzseiten zu finden sind (Beispiel).
  • Übersetzte Inhalte: https://github.com/mdn/translated-content. Hier leben lokalisierte Inhalte. Gehen Sie hierhin, wenn Sie helfen möchten, Seiten in eine unserer aktiv gepflegten Sprachen zu übersetzen.
  • Workflows: https://github.com/mdn/workflows Eine wachsende Sammlung von wiederverwendbaren GitHub Actions zur Verwendung in MDN Web Docs-Repositories.

Codebeispiel

Codebeispiele und Demos

Die GitHub-Organisation von MDN Web Docs enthält eine große Anzahl von Beispiel-Repos. Diese enthalten im Allgemeinen eigenständige Codebeispiele, die häufig von unseren Seiten verlinkt werden. Gelegentlich finden Sie eines dieser Beispiele, das auf einer Seite mit einem Makroaufruf wie diesem eingebettet ist — {{EmbedGHLiveSample("css-examples/learn/tasks/grid/grid1.html", '100%', 700)}}.

Denken Sie immer daran, dass, wenn Sie den Code auf einer beliebigen Seite aktualisieren, Sie auch das entsprechende Beispiel-Repo aktualisieren müssen.