Rollen und Teams bei MDN Web Docs
Der Erfolg und das Wachstum des Projekts MDN Web Docs sind zu einem großen Teil unserer Community von Mitwirkenden zu verdanken. Einige Mitwirkende widmen einen Teil ihrer Zeit den täglichen Aufgaben, die für den Betrieb von MDN Web Docs anfallen. Änderungen an der Website, einschließlich Wartungsarbeiten, werden von Angestellten, Auftragnehmenden und einem Netzwerk von Partnern vorgenommen, die sich für den Zustand, das Wachstum und die Pflege von MDN Web Docs einsetzen. Das Projekt stützt sich bei der Verwaltung und Einbindung der Änderungen dieser verschiedenen Gruppen stark auf Rollen und Teams in der MDN-Organisation auf GitHub. Eine Liste der aktuellen Mitglieder der Organisation finden Sie unter github.com/orgs/mdn.
Beiträge aus der Community sind für dieses Open-Source-Projekt von unschätzbarem Wert. Mitwirkende können ihre Arbeit an MDN Web Docs nutzen, um ihre Fähigkeiten im Schreiben, ihre technischen Kenntnisse und ihre Fähigkeit zur Zusammenarbeit mit Menschen unterschiedlicher Herkunft zu zeigen. Dieser Abschnitt beschreibt die Rollen, die Sie bei Ihrer freiwilligen Mitarbeit am Projekt MDN Web Docs übernehmen können.
Rollen
Im Projekt MDN Web Docs können Sie die Rolle eines Mitwirkenden, eines Organisationsmitglieds, eines Maintainers oder eines Owners übernehmen. Der Wechsel von einer Rolle zur nächsten erfolgt schrittweise. Wenn Ihre Verantwortlichkeiten wachsen, können Sie auch mehrere Rollen gleichzeitig ausüben. Rollen wie die eines eingeladenen Experten können Sie direkt übernehmen, wenn Sie Fachkenntnisse in einem bestimmten Bereich nachgewiesen haben.
Unabhängig davon, welche Rolle Sie in diesem Projekt übernehmen, sind Sie immer auch ein Mitwirkender. Die Rolle des Mitwirkenden bildet die Grundlage für alle anderen Rollen. Wenn Sie in irgendeiner Funktion an diesem Projekt arbeiten, müssen Sie daher die Anforderungen dieser Rolle erfüllen.
Mitwirkende
Mitwirkende, auch Community-Mitglieder genannt, bringen ihre Zeit, Fähigkeiten, Meinungen und Ideen in das Projekt ein. Sie arbeiten direkt am Projekt und schaffen einen Mehrwert dafür. Neben dem Schreiben und Testen von Code zählen dazu das Erstellen und Aktualisieren von Dokumentation, Recherchen, das Beheben von Fehlern und die Unterstützung anderer Community-Mitglieder.
Je nachdem, wie häufig Sie Beiträge leisten, können Sie gelegentlich oder aktiv mitwirken. Wenn Sie einen besonders großen Beitrag zum Projekt leisten, können Sie als Mitwirkender im Rampenlicht nominiert oder zum Organisationsmitglied ernannt werden.
Wenn Sie neu hier sind und mitwirken möchten, lesen Sie unseren Leitfaden für den Einstieg und sehen Sie sich die Repositorys der MDN-Organisation auf GitHub an.
Als Mitwirkender können Sie sich auf folgende Weise am Projekt beteiligen:
- Nehmen Sie auf den Kommunikationskanälen an Diskussionen in der Community teil.
- Unterstützen Sie andere Mitwirkende bei ihren Pull Requests und Issues oder betreuen Sie neue Mitwirkende.
- Melden Sie Fehler. Weitere Informationen finden Sie bei den wichtigsten Repositorys.
- Kommentieren Sie Issues, um Diskussionen zu einer konstruktiven Lösung zu führen.
- Bearbeiten Sie offene Issues, beispielsweise im Repository
content, indem Sie Pull Requests einreichen. - Nehmen Sie an Community-Veranstaltungen teil.
- Helfen Sie dabei, das MDN-Projekt bekannter zu machen.
Anforderungen:
Um mitzuwirken, müssen Sie Folgendes beachten:
- Mozillas Verhaltenskodex
- Die jeweiligen Richtlinien der Repositorys. Projektspezifische Hinweise oder Richtlinien finden Sie gegebenenfalls in der Datei
CONTRIBUTING.mdim Stammverzeichnis des Projekt-Repositorys.
Berechtigungen:
Mitwirkende haben folgende Möglichkeiten:
- Einladungen zu Veranstaltungen für Mitwirkende erhalten.
- Organisationsmitglied werden.
Organisationsmitglieder
Organisationsmitglieder sind etablierte Mitwirkende, die regelmäßig am Projekt MDN Web Docs teilnehmen und Beiträge leisten. Von ihnen wird erwartet, dass sie im Interesse des Projekts handeln.
Anforderungen:
Um Organisationsmitglied zu werden, müssen Sie mindestens eine der folgenden Anforderungen erfüllen:
- Sie haben mindestens zwei zusammengeführte Pull Requests eingereicht, mit denen mindestens zwei Issues gelöst wurden.
- Sie haben mindestens zwei Monate lang zu MDN-Web-Docs-Projekten beigetragen.
- Sie haben aktiv in mindestens einem Projektbereich mitgewirkt.
Die folgenden beiden Anforderungen sind verpflichtend:
- Sie haben die Zwei-Faktor-Authentifizierung für Ihr GitHub-Konto aktiviert.
- Sie haben signierte Commits aktiviert.
Berechtigungen:
Organisationsmitglieder haben auf GitHub Berechtigungen auf Organisationsebene.
Maintainer
Maintainer sind etablierte Mitwirkende, die für ein oder mehrere MDN-Projekte verantwortlich sind. Von ihnen wird erwartet, dass sie an Entscheidungen über die Richtlinien und Prioritäten des Projekts mitwirken. Wie Sie jemanden als Maintainer nominieren können, erfahren Sie im Abschnitt zum Verfahren.
Als Maintainer übernehmen Sie folgende Aufgaben:
- Sie legen die Prioritäten für das Projekt fest, für das Sie verantwortlich sind.
- Sie nehmen an Community-Treffen teil.
- Sie betreuen neue und erfahrene Mitwirkende aller anderen Rollen.
- Je nach Ihren Fähigkeiten schlagen Sie in Ihrem Projektbereich die folgenden Verbesserungen vor, genehmigen sie oder setzen sie um:
- Verbesserungen an Code und Infrastruktur
- Verbesserungen an Inhalten
- Verbesserungen an Prozessen
Anforderungen:
Um Maintainer werden zu können, müssen Sie mindestens eine der folgenden Anforderungen erfüllen:
- Sie haben mindestens sechs Monate Erfahrung als eingeladener Experte gesammelt.
- Sie haben umfassende Kenntnisse des Projekts in mehreren Bereichen nachgewiesen.
- Sie haben gezeigt, dass Sie unabhängig vom Einfluss anderer Mitglieder Entscheidungen zum Wohl des Projekts treffen können.
- Sie haben andere Mitwirkende besonders gut betreut.
- Sie haben sich bereit erklärt, mindestens 16 Stunden pro Monat für die Arbeit am Projekt aufzuwenden.
- Sie haben an dem alle zwei Monate stattfindenden Community-Treffen teilgenommen.
Hinweis: Wenn Sie jemanden kennen, der für diese Rolle geeignet ist, können Sie diese Person als Maintainer nominieren.
Berechtigungen:
Maintainer können Pull Requests genehmigen und zusammenführen.
Owner
Owner haben weitreichende Berechtigungen, um Benutzer und GitHub-Teams zu verwalten, Zugriffsrechte für die Repositorys der MDN-Organisation zu verwalten, Repository-Einstellungen zu pflegen und Änderungen in der Produktionsumgebung bereitzustellen. Für Owner gelten sämtliche Anforderungen der anderen Rollen für Mitwirkende.
Hinweis: Die Rolle des Owners ist derzeit auf Mitarbeitende von Mozilla beschränkt.
Anforderungen:
Zusätzlich zu den Aufgaben der anderen Rollen für Mitwirkende haben Owner folgende Verantwortlichkeiten:
- Sie befolgen die Regeln des MDN-Teams und setzen sie durch, einschließlich der Richtlinien für die Teilnahme an der Community und der Mozilla-Richtlinien.
- Sie befolgen die Richtlinien der MDN-Organisation und gehen mit gutem Beispiel voran.
- Sie schlagen über das Pull-Request-Verfahren neue Richtlinien vor, dokumentieren sie und setzen sie um.
- Sie verfolgen Issues und Diskussionen in der gesamten MDN-Organisation und beteiligen sich daran.
- Sie stellen sicher, dass ein Issue oder Pull Request innerhalb einer Woche Rückmeldung von mindestens einem Mitglied erhält.
- Sie archivieren oder löschen Repositorys, die nicht mehr gepflegt werden.
- Sie besprechen GitHub-Funktionen, entscheiden, welche davon verwendet werden, und dokumentieren diese Entscheidungen.
Berechtigungen:
Owner können:
- Bei Bedarf Owner und Mitglieder der Organisation hinzufügen und entfernen.
- Bei Bedarf Mitarbeitende zu bestimmten Repositorys hinzufügen und daraus entfernen.
- Bei Bedarf Repositorys hinzufügen, entweder als neue Projekte oder durch Übertragung.
Übersicht über die Rollen
| Rolle | Anforderungen | Berechtigungen |
|---|---|---|
| Mitwirkende | Verhaltenskodex und Richtlinien für Beiträge befolgen | - Einladungen zu Veranstaltungen für Mitwirkende - Möglichkeit, Organisationsmitglied zu werden |
| Organisationsmitglieder | - 2FA für das GitHub-Konto aktivieren - Signierte Commits aktivieren Mindestens eine der folgenden Anforderungen: - Mindestens zwei Issues lösen - Mindestens zwei Monate mitwirken - Aktiv in einem Projektbereich mitwirken |
Zugriffsrechte auf Organisationsebene |
| Maintainer | Mindestens eine der folgenden Anforderungen: - Mindestens sechs Monate eingeladener Experte sein - Mehrere Projektbereiche kennen - Im Interesse des gesamten Projekts handeln - Andere Mitwirkende betreuen - Mindestens 16 Stunden pro Monat am Projekt arbeiten - An Community-Treffen teilnehmen |
Pull Requests genehmigen und zusammenführen |
| Owner | Auf Mitarbeitende von Mozilla beschränkt | - Zugriff verschiedener Rollen auf Repositorys verwalten - Repositorys und Projekte hinzufügen oder archivieren |
Besondere Rollen
Einige Rollen für Mitwirkende haben differenziertere Verantwortlichkeiten und besondere Voraussetzungen. Dazu gehören Mitwirkende im Rampenlicht, eingeladene Experten und Community-Manager.
Mitwirkende im Rampenlicht
Mitwirkende im Rampenlicht sind Personen, die mit ihren Beiträgen zu MDN Web Docs Außergewöhnliches geleistet haben. Ihre Beiträge können Pull Requests zur Verbesserung des Projekts, die Unterstützung von Community-Mitgliedern auf verschiedenen Kommunikationskanälen oder in Lernforen sowie Rückmeldungen zu GitHub-Issues und Pull Requests umfassen.
Jeden Monat stellen wir auf der MDN-Website eine mitwirkende Person vor. Wie Sie jemanden dafür nominieren können, erfahren Sie im Abschnitt zum Verfahren.
Eingeladene Experten
Eingeladene Experten haben sich bei MDN durch ihre Beiträge, ihre Beteiligung an Diskussionen und Reviews oder durch nachgewiesene Kenntnisse in einem bestimmten Fachgebiet ausgezeichnet. Sie sind für einen bestimmten Themenbereich oder eine Komponente des MDN-Projekts verantwortlich. Zu ihren Aufgaben gehören die Prüfung und Genehmigung von Pull Requests in ihrem Themen- oder Projektbereich, die Beantwortung technischer Fragen und die allgemeine Pflege ihres jeweiligen Projekts. Wie Sie jemanden als eingeladenen Experten nominieren können, erfahren Sie im Abschnitt zum Verfahren.
Zusätzlich zu den Verantwortlichkeiten eines Organisationsmitglieds sind eingeladene Experten für Folgendes zuständig:
- Sie befolgen das Verfahren zur Prüfung von Pull Requests.
- Sie prüfen Pull Requests in ihrem Themenbereich.
- Sie helfen anderen Mitwirkenden dabei, Reviewer zu werden.
Wenn in ihrem Themenbereich Pull Requests eröffnet werden, werden eingeladene Experten automatisch als Reviewer zugewiesen. Gibt es in einem Themenbereich mehrere Experten, werden sie den Pull Requests anhand einer Strategie zum Lastausgleich zugewiesen.
Anforderungen:
Um eingeladener Experte werden zu können, müssen Sie mindestens eine der folgenden Anforderungen erfüllen:
- Sie haben fundierte Kenntnisse in einem bestimmten Themenbereich nachgewiesen.
- Sie haben sich verpflichtet, die Verantwortung für den Ihnen zugewiesenen Themenbereich zu übernehmen.
- Sie haben neue und gelegentlich Mitwirkende unterstützt und ihnen geholfen, Pull Requests für die Zusammenführung vorzubereiten.
- Sie haben an dem alle zwei Monate stattfindenden Community-Treffen teilgenommen.
Berechtigungen:
Eingeladene Experten werden dem Team für eingeladene Experten und dem entsprechenden Themen- oder Projektteam hinzugefügt. Sie können:
- Auf das benötigte Repository zugreifen, um Commits vorzunehmen sowie Pull Requests zu genehmigen und zusammenzuführen.
- Andere Mitglieder als eingeladene Experten empfehlen und über ihre Aufnahme abstimmen.
- An der wöchentlichen Redaktionsbesprechung von MDN Web Docs teilnehmen.
Community-Manager
Community-Manager haben in vielerlei Hinsicht eine eigenständige Rolle. Sie übernehmen viele der gleichen Verantwortlichkeiten wie Maintainer. Darüber hinaus haben Community-Manager folgende Aufgaben:
- Sie bearbeiten Meldungen über Verstöße gegen unseren Verhaltenskodex, der den Richtlinien von Mozilla für die Teilnahme an der Community entspricht, und entscheiden über angemessene Maßnahmen.
- Sie organisieren und leiten Community-Veranstaltungen.
- Sie organisieren projektbezogene Community-Treffen.
- Sie legen Medienstrategien fest, um das MDN-Projekt bekannter zu machen.
- Sie gestalten und implementieren den Einführungsprozess für Mitwirkende.
- Sie führen neue Mitwirkende und Benutzer ein.
- Sie sorgen für den Zustand und das Wohlergehen des MDN-Projekts und aller Beteiligten.
- Sie ermitteln Möglichkeiten zur Automatisierung, um die langfristige Tragfähigkeit des Projekts zu verbessern, und unterstützen deren Umsetzung.
- Sie treffen sich mit Mitwirkenden und Partnern und sorgen für eine gute Zusammenarbeit.
- Sie helfen gegebenenfalls bei der Sichtung von Issues und der Prüfung von Pull Requests.
- Sie behalten alle Kommunikationskanäle im Blick.
- Sie würdigen Mitwirkende, die außergewöhnliche Arbeit geleistet und/oder besonderes Engagement für das MDN-Projekt gezeigt haben.
Verfahren
>Maintainer nominieren
Informieren Sie sich darüber, wer Maintainer werden kann.
Um jemanden als Maintainer zu nominieren, erstellen Sie einen Issue auf GitHub:
- Klicken Sie im Repository
mdn/mdnauf der RegisterkarteIssuesrechts auf die Schaltfläche New issue. - Klicken Sie unter „Nominate a maintainer“ auf die Schaltfläche Get started.
- Tragen Sie in das Formular Einzelheiten zu den Beiträgen der Person ein, die Sie nominieren, und senden Sie es ab.
Mitwirkende für das Rampenlicht nominieren
Informieren Sie sich darüber, wer als Mitwirkender im Rampenlicht vorgestellt werden kann.
Um jemanden dafür zu nominieren, erstellen Sie einen Issue auf GitHub:
- Klicken Sie im Repository
mdn/mdnauf der RegisterkarteIssuesrechts auf die Schaltfläche New issue. - Klicken Sie unter „Nominate a spotlight contributor“ auf die Schaltfläche Get started.
- Tragen Sie in das Formular Einzelheiten zu den Beiträgen der Person ein, die Sie nominieren, und senden Sie es ab.
Das MDN-Team setzt sich mit der nominierten Person in Verbindung, um die Informationen einzuholen, die unter „Contributor Spotlight“ auf der Website veröffentlicht werden sollen.
Eingeladene Experten nominieren
Informieren Sie sich darüber, wer eingeladener Experte werden kann.
Um jemanden als eingeladenen Experten zu nominieren, erstellen Sie einen Issue auf GitHub:
- Klicken Sie im Repository
mdn/mdnauf der RegisterkarteIssuesrechts auf die Schaltfläche New issue. - Klicken Sie unter „Nominate an invited expert“ auf die Schaltfläche Get started.
- Tragen Sie in das Formular Einzelheiten zu den Beiträgen der Person ein, die Sie nominieren, und senden Sie es ab.
Eine Rolle abgeben oder den Emeritus-Status beantragen
Lebensumstände ändern sich, und damit kann sich auch ändern, wie viel Zeit Sie für Ihre Mitarbeit aufbringen können. Je nach Situation möchten Sie vielleicht:
- Vorübergehend eine Pause vom Projekt einlegen.
- Eine weniger anspruchsvolle Rolle übernehmen.
- Sich vollständig aus dem Projekt zurückziehen und den Emeritus-Status beantragen.
In all diesen Fällen können Sie Ihre Situation und Ihre derzeitigen Möglichkeiten zur Mitarbeit gern mit dem MDN-Team besprechen.
Inaktive Mitwirkende zurückstufen oder entfernen
Mitwirkende können zurückgestuft oder aus dem Projekt ausgeschlossen werden, wenn sie ihre Verantwortlichkeiten und Anforderungen nicht erfüllen. Dazu gehören wiederholte Inaktivität oder ein Verstoß gegen den Verhaltenskodex.
Die Zurückstufung oder der Ausschluss eines Mitwirkenden wird von einem Teilnehmer während eines Maintainer-Treffens vorgeschlagen. Der Teilnehmer legt Informationen vor, die den Antrag auf Zurückstufung oder Ausschluss begründen. Nach einer Diskussion stimmen Maintainer und Community-Manager darüber ab.
Das Entfernen inaktiver Mitwirkender schützt das Projekt und seine Ergebnisse und eröffnet zugleich neuen Mitwirkenden die Möglichkeit, Aufgaben zu übernehmen.
Wir definieren Inaktivität wie folgt:
- Mindestens sechs Monate lang keine Beiträge zum Projekt.
- Mindestens drei Monate lang keine Reaktion auf Mitteilungen.
Inaktivität schadet dem Projekt: Sie kann zu unerwarteten Verzögerungen, zum Weggang Mitwirkender und zu einem Vertrauensverlust in das Projekt führen. Mitwirkende müssen aktiv sein, um mit gutem Beispiel voranzugehen und ihr Engagement für das Projekt zu zeigen.
Bitte informieren Sie das Community-Team, wenn sich Ihre zeitlichen Möglichkeiten ändern, damit Sie nicht zurückgestuft oder ausgeschlossen werden. Stattdessen können Sie sich selbst dafür entscheiden, eine Zeit lang zu pausieren oder in den Emeritus-Status zu wechseln.
Teams
Wir verwalten Teams mithilfe der Funktion GitHub-Teams. Wenn Sie einem Team hinzugefügt werden, bedeutet das, dass Sie Ihr Interesse an einer engeren Mitarbeit am Projekt bekundet haben. Damit gehen auch einige zusätzliche Verantwortlichkeiten und Rechte einher:
-
Teammitglieder werden üblicherweise für ihre jeweiligen Interessengebiete in die Datei CODEOWNERS eingetragen.
-
Wenn ein Pull Request Dateien in Ihrem Zuständigkeitsbereich betrifft, werden Sie anhand der CODEOWNERS-Datei durch den Lastausgleichsalgorithmus von GitHub automatisch als Reviewer hinzugefügt.
-
Teammitglieder haben erweiterte Zugriffsrechte auf Repositorys. Berechtigungen werden nur für die Repositorys vergeben, auf die ein Mitglied zugreifen muss.
Zu den Teams in der MDN-Organisation auf GitHub gehören:
@Core: Das Kernteam von MDN Web Docs@mdn-community-engagement: Personen, die für die Zusammenarbeit mit der Community in unseren Repositorys verantwortlich sind@mdn-product: Personen, die für das Produkt MDN Plus verantwortlich sind@localization-team-leads: Personen, die unsere einzelnen Lokalisierungsteams leiten@OWD: Mitwirkende der gemeinnützigen Organisation Open Web Docs@sre: Site-Reliability-Engineers, die MDN Web Docs unterstützen@yari-content: Das übergeordnete Team für alle Reviewer von MDN-Web-Docs-Inhalten- Für die verschiedenen Themenbereiche gibt es Unterteams: Barrierefreiheit, Add-ons, CSS, HTML, HTTP, JavaScript, SVG, Web API und WebAssembly. Beispiele dafür sind
@yari-content-cssund@yari-content-svg. - Außerdem gibt es Unterteams für verschiedene Sprachen: brasilianisches Portugiesisch, Chinesisch, Französisch, Japanisch, Koreanisch, Russisch und Spanisch. Beispiele dafür sind
@yari-content-frund@yari-content-ko.
- Für die verschiedenen Themenbereiche gibt es Unterteams: Barrierefreiheit, Add-ons, CSS, HTML, HTTP, JavaScript, SVG, Web API und WebAssembly. Beispiele dafür sind
Um Mitglied eines Teams zu werden, müssen Sie:
- Zustimmen, unsere Richtlinien für die Teilnahme an der Community einzuhalten.
- Mozillas Anforderungen für Commit-Zugriff zustimmen.
- Die Zwei-Faktor-Authentifizierung (2FA) für Ihr GitHub-Konto einrichten.
Kontakt zum MDN-Team
Für Anfragen und Rückmeldungen wenden Sie sich bitte an mdn-web-docs-community (at) mozilla (.com).