MDN Web Docs Repositories

MDN Web Docs ist ein komplexes Projekt mit vielen beweglichen Teilen. Es ist eine gute Idee, sich mit den verschiedenen Repositories des Projekts vertraut zu machen. Dieses Dokument soll Ihnen helfen, die verschiedenen Repositories (Repos) zu finden, die Sie benötigen könnten, wenn Sie zu verschiedenen Teilen des MDN Web Docs-Projekts beitragen möchten.

Repository-Kategorien

Kategorie 1

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

Ein Projekt der Kategorie 1 sollte mindestens 3 Mitglieder haben, darunter mindestens zwei mit Administratorrechten.

Kategorie 2

Diese Repositories konzentrieren sich hauptsächlich auf die Unterstützung von Inhalten wie Codebeispiele, den MDN Web Docs-Lernbereich, Lokalisierung und Beispielprojekte. Beispiele sind:

Ein Projekt der Kategorie 2 sollte mindestens 2 Mitglieder haben, darunter mindestens eines mit Administratorrechten.

Kategorie 3

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

Ein Projekt der Kategorie 3 benötigt 1 Administrator.

Kern-Repos

  • Kerninhalt: https://github.com/mdn/content. Das wichtigste Repo für MDN Web Docs-Inhalte — hier wird der gesamte zentrale englische Inhalt der Seite gespeichert, und hier nehmen Sie alle Standardänderungen an den Seiteninhalten vor.
  • 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 übergeordneten Seitenstruktur oder der Rendering-Mechanik vornehmen möchten.
  • Browser-Kompatibilitätsdaten: https://github.com/mdn/browser-compat-data. Hier werden die Daten gespeichert, die zur Erstellung der Browser-Kompatibilitätstabellen auf unseren Referenzseiten verwendet werden (Beispiel). Wenn Sie Informationen über die Browser-Kompatibilität von Webfunktionen haben — oder bereit und in der Lage sind, einige Recherchen und/oder Experimente durchzuführen — können Sie helfen, die Browser-Kompatibilitätsdaten zu aktualisieren.
  • Interaktive Beispiele: https://github.com/mdn/interactive-examples. Dieses Repo speichert die Beispiel-Codeblöcke, die am Anfang vieler unserer Referenzseiten zu finden sind (Beispiel). Bearbeiten Sie diese Beispiele hier.
  • Bob, auch bekannt als Builder of Bits: https://github.com/mdn/bob Dieses Repo speichert den Rendering-Code, der die schönen editierbaren, kopierbaren Beispiele produziert, die am Anfang vieler unserer Referenzseiten zu finden sind (Beispiel).
  • Übersetzte Inhalte: https://github.com/mdn/translated-content. Hier befinden sich die lokalisierten Inhalte. Gehen Sie hierher, wenn Sie helfen möchten, Seiten in eine unserer aktiv betreuten Sprachen zu übersetzen.
  • Workflows: https://github.com/mdn/workflows Eine wachsende Sammlung von wiederverwendbaren GitHub-Aktionen für die Verwendung in MDN Web Docs-Repositories.

Codebeispiel

Codebeispiele und Demos

Die MDN Web Docs GitHub-Organisation enthält eine große Anzahl von Beispiel-Repos. Diese enthalten in der Regel eigenständige Codebeispiele, die zu groß sind oder nicht mit dem EmbedLiveSample Makro gerendert werden können. Diese Beispiele werden mithilfe eines Makroaufrufs wie diesem — {{EmbedGHLiveSample("css-examples/learn/tasks/grid/grid1.html", '100%', 700)}} in die Inhaltsseiten eingebettet.

Vergessen Sie nie, wenn Sie den Code auf einer bestimmten Seite aktualisieren, dass Sie auch das entsprechende Beispielrepo aktualisieren müssen.