MDN Web Docs Rollen und Teams
Der Erfolg und das Wachstum des MDN Web Docs-Projekts sind zu einem großen Teil der Community der Mitwirkenden zu verdanken. Einige Mitwirkende haben sich verpflichtet, einen Teil ihrer Zeit zu investieren, um bei den täglichen Aufgaben zur Verwaltung der MDN Web Docs zu helfen. Änderungen an der Website, einschließlich Wartungsarbeiten, werden von Mitarbeitern, Auftragnehmern und einem Netzwerk von Partnern durchgeführt, die alle der Gesundheit, dem Wachstum und der Pflege der MDN Web Docs gewidmet sind. Das Projekt stützt sich stark auf Rollen und Teams in der MDN-Organisation auf GitHub, um Änderungen von diesen verschiedenen Gruppen zu verwalten und zu integrieren. Eine Liste der aktuellen Mitglieder der Organisation finden Sie unter github.com/orgs/mdn.
Die Beiträge der Community sind eine immense Hilfe für dieses Open-Source-Projekt. Mitwirkende können ihre Arbeit an den MDN Web Docs nutzen, um ihre Schreib-, technischen und Kooperationsfähigkeiten sowie die Fähigkeit zu demonstrieren, mit Menschen aus unterschiedlichen Hintergründen zusammenzuarbeiten. Dieser Abschnitt beschreibt die Rollen, die Sie übernehmen können, während Sie sich freiwillig am MDN Web Docs-Projekt beteiligen.
Rollen
Im MDN Web Docs-Projekt können Sie die Rolle eines Mitwirkenden, eines Organisationsmitglieds, eines Maintainers oder eines Eigentümers übernehmen. Der Fortschritt von einer Rolle zur nächsten ist ein schrittweiser Prozess. Mit der Erweiterung Ihrer Verantwortung könnten Sie gleichzeitig mehr als eine Rolle ausüben. Rollen wie eingeladener Experte können direkt übernommen werden, wenn Sie Fachwissen in einem bestimmten Bereich nachgewiesen haben.
Unabhängig von der Rolle, die Sie in diesem Projekt übernehmen, sind Sie immer ein Mitwirkender. Ein Mitwirkender ist die Basisrolle, auf der alle anderen Rollen aufbauen. Wenn Sie in diesem Projekt in irgendeiner Funktion arbeiten, müssen Sie die Anforderungen der Rolle des Mitwirkenden erfüllen.
Mitwirkender
Mitwirkende oder Community-Teilnehmer tragen mit ihrer Zeit, ihren Fähigkeiten, Meinungen und Ideen zum Projekt bei. Mitwirkende arbeiten direkt am Projekt und tragen zu dessen Mehrwert bei. Neben dem Schreiben und Testen von Code umfassen Beiträge das Erstellen und Aktualisieren von Dokumentationen, Recherchieren, Beheben von Fehlern und Helfen anderer Community-Mitglieder.
Je nach Häufigkeit Ihrer Beiträge können Sie jemand sein, der gelegentlich beiträgt oder ein aktiver Mitwirkender sein. Wenn Sie einen großen Einfluss auf das Projekt zeigen, können Sie als Highlight-Mitwirkender nominiert oder zum Organisationsmitglied befördert werden.
Wenn Sie neu hier sind und Mitwirkender werden möchten, werfen Sie einen Blick auf unseren Leitfaden zum Einstieg und die Repositories der MDN GitHub Organisation.
Als Mitwirkender können Sie sich durch folgende Aktivitäten am Projekt beteiligen:
- Teilnahme an Community-Diskussionen auf den Kommunikationskanälen.
- Unterstützung anderer Mitwirkender mit ihren Pull Requests und Problemen oder Mentoring neuer Mitwirkender.
- Einreichen von Fehlerberichten. Weitere Informationen finden Sie auf den Haupt-Repositories.
- Kommentieren von Problemen, um Gespräche in Richtung einer fruchtbaren Lösung zu lenken.
- Bearbeitung offener Probleme (zum Beispiel im
content
Repository) durch Einreichen von Pull Requests. - Teilnahme an Community-Veranstaltungen.
- Mithelfen, das MDN-Projekt zu fördern.
Anforderungen:
Um ein Mitwirkender zu sein, müssen Sie folgende Anforderungen erfüllen:
- Mozillas Verhaltenskodex befolgen.
- Die spezifischen Richtlinien für jedes Repository einhalten. Wenn es projektbezogene Hinweise oder Richtlinien gibt, finden Sie diese in einer Datei
CONTRIBUTING.md
im Stammverzeichnis des Projekt-Repositories.
Privilegien:
Mitwirkende genießen folgende Privilegien:
- Einladungen zu Mitwirkenden-Veranstaltungen.
- Berechtigung, ein Organisationsmitglied zu werden.
Organisationsmitglied
Organisationsmitglieder sind etablierte Mitwirkende, die regelmäßig am MDN Web Docs-Projekt teilnehmen und dazu beitragen. Sie werden erwartet, im Interesse des Projekts zu handeln.
Anforderungen:
Um ein Organisationsmitglied zu sein, müssen Sie eine oder mehrere der folgenden Anforderungen erfüllen:
- Zwei oder mehr Pull Requests geöffnet haben, die zur Lösung von zwei oder mehr Problemen fusioniert wurden.
- Mindestens zwei Monate lang zu MDN Web Docs-Projekten beigetragen haben.
- Aktiv in mindestens einem Projektbereich beigetragen haben.
Die folgenden zwei Anforderungen sind obligatorisch:
- Zwei-Faktor-Authentifizierung für Ihr GitHub-Konto aktiviert.
- Signierte Commits aktiviert.
Privilegien:
Organisationsmitglieder haben Privilegien auf der Organisationsebene bei GitHub.
Maintainer
Maintainer sind etablierte Mitwirkende, die für ein oder mehrere Projekte auf MDN verantwortlich sind. Sie werden erwartet, an Entscheidungen über die Richtlinien und Prioritäten des Projekts teilzunehmen. Siehe den Prozess zur Nominierung einer Person als Maintainer.
Als Maintainer beteiligen Sie sich an den folgenden Aktivitäten:
- Festlegen von Prioritäten für das Projekt, für das Sie verantwortlich sind.
- Teilnahme an Community-Meetings.
- Mentoring neuer und bestehender Mitwirkender in allen anderen Rollen.
- Je nach Fähigkeiten, Vorschläge machen, genehmigen oder Implementieren in Ihrem Projektbereich:
- Verbesserungen von Code und Infrastruktur
- Verbesserungen von Inhalten
- Prozessverbesserungen
Anforderungen:
Um für die Rolle des Maintainers in Frage zu kommen, müssen Sie eine oder mehrere der folgenden Anforderungen erfüllen:
- Mindestens sechs Monate als eingeladener Experte Erfahrung gesammelt haben.
- Breites Wissen über das Projekt in mehreren Bereichen demonstriert haben.
- Die Fähigkeit bewiesen haben, unabhängig von den Einflüssen anderer Mitglieder zum Wohle des Projekts zu urteilen.
- Die Qualität des Mentorings anderer Mitwirkender gezeigt haben.
- Zugestimmt haben, mindestens 16 Stunden pro Monat an dem Projekt zu arbeiten.
- Am Community-Meeting, das alle zwei Monate stattfindet, teilgenommen haben.
Hinweis: Wenn Sie denken, dass jemand für diese Rolle geeignet ist, können Sie einen Maintainer nominieren.
Privilegien:
Maintainer haben die Berechtigung, Pull Requests zu genehmigen und zusammenzuführen.
Eigentümer
Eigentümer verfügen über umfangreiche Berechtigungen zur Verwaltung von Benutzern und GitHub-Teams, zur Verwaltung des Zugriffs auf Repositories in der MDN-Organisation, zur Verwaltung der Repository-Einstellungen und zur Bereitstellung in der Produktion. Eigentümer sind an alle Anforderungen der anderen Rollen gebunden.
Hinweis: Die Rolle eines Eigentümers ist derzeit auf Mozilla-Mitarbeiter beschränkt.
Anforderungen:
Zusätzlich zu den Verantwortlichkeiten anderer Rollen haben Eigentümer die folgenden Aufgaben:
- Befolgung und Durchsetzung der Normen des MDN-Teams, einschließlich der Community-Teilnahmerichtlinien und Mozilla-Richtlinien.
- Befolgung der MDN-Organisationsrichtlinien und Vorbildfunktion.
- Vorschlagen, Dokumentieren und Implementieren neuer Richtlinien über den Pull-Request-Prozess.
- Folgen und sich an Problemen und Diskussionen in der MDN Organisation beteiligen.
- Sicherstellen, dass ein Problem oder Pull-Request innerhalb einer Woche Feedback von einem oder mehreren Mitgliedern erhält.
- Archivierung oder Löschen unmaintaineter Repositories.
- Besprechung von GitHub-Features, Auswahl der zu verwendenden und Dokumentation der Entscheidungen.
Privilegien:
Eigentümer können:
- Organisationsinhaber und -mitglieder bei Bedarf hinzufügen und entfernen.
- Mitarbeiter spezifischen Repositories bei Bedarf hinzufügen und entfernen.
- Repositories hinzufügen (als neue Projekte oder Transfers) bei Bedarf.
Zusammenfassung der Rollen
Rolle | Anforderungen | Privilegien |
---|---|---|
Mitwirkender | Befolgen des Verhaltenskodex und der Beitragsrichtlinien | - Einladungen zu Mitwirkenden-Veranstaltungen - Berechtigung, ein Organisationsmitglied zu werden |
Organisationsmitglied | - 2FA für das GitHub-Konto aktivieren - Signierte Commits aktivieren Eine oder mehrere von: - Lösen von zwei oder mehr Problemen - Mindestens zwei Monate Beiträge - Aktive Beiträge in einem Projektbereich |
Zugriffsrechte auf Organisationsebene |
Maintainer | Eine oder mehrere von: - Mindestens sechs Monate eingeladener Experte - Wissen in mehreren Projektbereichen - Handeln zum Wohl des Projekts insgesamt - Mentoring anderer Mitwirkender - Mindestens 16 Stunden pro Monat am Projekt arbeiten - Teilnahme an Community-Meetings |
Pull Requests genehmigen und zusammenführen |
Eigentümer | Beschränkt auf Mozilla-Mitarbeiter | - Zugang zu Repositories und Projekten verwalten - Repositories und Projekte hinzufügen oder archivieren |
Besondere Rollen
Einige Rollen von Mitwirkenden haben differenziertere Verantwortlichkeiten und besondere Zulassungsbedingungen. Dazu gehören Highlight-Mitwirkender, eingeladener Experte und Community Manager.
Highlight-Mitwirkender
Highlight-Mitwirkende sind Personen, die mit ihren Beiträgen zu den MDN Web Docs über das normale Maß hinausgegangen sind. Ihre Beiträge erfolgen in Form von Pull Requests zur Verbesserung des Projekts, Unterstützung von Community-Mitgliedern in verschiedenen Kommunikationskanälen oder Lernforen oder durch Bereitstellung von Feedback zu GitHub-Problemen und Pull Requests.
Wir präsentieren jeden Monat einen Highlight-Mitwirkenden auf der MDN-Website. Sehen Sie sich den Prozess an, um jemanden als Highlight-Mitwirkenden zu nominieren.
Eingeladener Experte
Eingeladene Experten haben eine Erfolgsbilanz bei ihren Beiträgen zu MDN, der Teilnahme an Diskussionen und Überprüfungen oder haben nachweislich Wissen in einem bestimmten Fachgebiet. Eingeladene Experten sind für einen bestimmten Themenbereich oder eine Komponente des MDN-Projekts verantwortlich. Sie sind verantwortlich für die Überprüfung und Genehmigung von Pull Requests in ihrem Themen- oder Projektbereich, die Beantwortung technischer Fragen und die Pflege der allgemeinen Gesundheit ihres spezifischen Projekts. Sehen Sie sich den Prozess an, um jemanden als eingeladener Experte zu nominieren.
Zusätzlich zu den Verantwortlichkeiten eines Organisationsmitglieds sind eingeladene Experten verantwortlich für:
- Befolgen des Überprüfungsleitfadens.
- Überprüfung der Pull Requests in ihrem Themenbereich.
- Unterstützung anderer Mitwirkender, Reviewer zu werden.
Eingeladene Experten werden automatisch für Überprüfungen zugewiesen, wenn Pull Requests in ihrem Themenbereich geöffnet werden. Wenn es mehr als einen Experten in einem Themenbereich gibt, werden sie mit einer Lastverteilungsstrategie Pull Requests zugewiesen.
Anforderungen:
Um als eingeladener Experte in Frage zu kommen, müssen Sie eine oder mehrere der folgenden Anforderungen erfüllen:
- Tiefes Wissen in einem bestimmten Themenbereich nachgewiesen haben.
- Verpflichtet sein, für ihren zugewiesenen Themenbereich verantwortlich zu sein.
- Neue und gelegentliche Mitwirkende unterstützt und geholfen haben, Pull Requests auf die Zusammenführung vorzubereiten.
- Am Community-Meeting, das alle zwei Monate stattfindet, teilgenommen haben.
Privilegien:
Eingeladene Experten werden dem Team der eingeladene Experten und dem entsprechenden Themen- oder Projektteam hinzugefügt. Eingeladene Experten können:
- Auf das erforderliche Repository für Commits und Pull Request Genehmigungen und Zusammenführungen zugreifen.
- Andere Mitglieder empfehlen und abstimmen, eingeladene Experten zu werden.
- An wöchentlichen MDN Web Docs-Redaktionstreffen teilnehmen.
Community Manager
Community Manager haben in vielerlei Hinsicht eine besondere Rolle. Community Manager teilen viele der gleichen Verantwortlichkeiten wie ein Maintainer. Darüber hinaus haben Community Manager folgende Verantwortlichkeiten:
- Behandlung von Berichten über Verstöße gegen unseren Verhaltenskodex, der Mozillas Community-Teilnahmerichtlinien umfasst, und Entscheidung über die entsprechende Maßnahme.
- Organisieren und durchführen von Community-Veranstaltungen.
- Organisation von projektrelevanten Meetings.
- Bestimmung von Medienstrategien zur Förderung des MDN-Projekts.
- Definition und Implementierung der Erfahrung beim Onboarding von Mitwirkenden.
- Einarbeitung neuer Mitwirkender und Nutzer.
- Sicherstellung der Gesundheit und des Wohlbefindens des MDN Projekts und aller Teilnehmer.
- Identifizierung und Unterstützung bei der Umsetzung von Automatisierungen zur Verbesserung der Projekt-Nachhaltigkeit.
- Aufbau und Pflege gesunder Beziehungen zu Mitwirkenden und Partnern.
- Unterstützung bei der Problemdiagnose und Überprüfung von Pull Requests, wo geeignet.
- Überwachung aller Kommunikationskanäle.
- Hervorhebung von Mitwirkenden, die außergewöhnliche Arbeit geleistet haben und/oder Engagement für das MDN Projekt gezeigt haben.
Prozesse
Eine/n Maintainer nominieren
Sehen Sie, wer ein Maintainer sein kann.
Um jemanden als Maintainer zu nominieren, öffnen Sie ein Issue auf GitHub:
- Klicken Sie auf der Registerkarte
Issues
im Repositorymdn/mdn
rechts auf die Schaltfläche New issue. - Klicken Sie unter "Nominieren eines Maintainers" auf die Schaltfläche Get started.
- Füllen Sie das Formular mit den Details der Beiträge der Person aus, die Sie nominieren, und senden Sie das Formular ab.
Eine/n Highlight-Mitwirkenden nominieren
Sehen Sie, wer ein Highlight-Mitwirkender sein kann.
Um jemanden als Highlight-Mitwirkender zu nominieren, öffnen Sie ein Issue auf GitHub:
- Klicken Sie auf der Registerkarte
Issues
im Repositorymdn/mdn
rechts auf die Schaltfläche New issue. - Klicken Sie unter "Nominieren eines Highlight-Mitwirkers" auf die Schaltfläche Get started.
- Füllen Sie das Formular mit den Details der Beiträge der Person aus, die Sie nominieren, und senden Sie das Formular ab.
Das MDN-Team wird mit der nominierten Person Kontakt aufnehmen, um deren Informationen auf der Website unter "Mitwirkender im Rampenlicht" zu veröffentlichen.
Einen/eine eingeladene/n Experten/in nominieren
Sehen Sie, wer ein eingeladener Experte sein kann.
Um jemanden als eingeladener Experte zu nominieren, öffnen Sie ein Issue auf GitHub:
- Klicken Sie auf der Registerkarte
Issues
im Repositorymdn/mdn
rechts auf die Schaltfläche New issue. - Klicken Sie unter "Nominieren eines eingeladenen Experten" auf die Schaltfläche Get started.
- Füllen Sie das Formular mit den Details der Beiträge der Person aus, die Sie nominieren, und senden Sie das Formular ab.
Zurücktreten oder Emeritus-Status beantragen
Das Leben verändert sich und somit auch die mögliche Verpflichtungsbereitschaft als Mitwirkender. Je nach Situation möchten Sie möglicherweise:
- Eine Pause vom Projekt nehmen.
- In eine weniger anspruchsvolle Rolle zurücktreten.
- Sich vollständig vom Projekt zurückziehen (Emeritus-Status beantragen).
In all diesen Situationen zögern Sie nicht, Ihre Situation und Ihr aktuelles Verpflichtungsniveau mit dem MDN-Team zu besprechen.
Herabstufung oder Entfernung inaktiver Mitwirkender
Ein Mitwirkender kann herabgestuft oder aus dem Projekt entfernt werden, wenn Verantwortlichkeiten und Anforderungen nicht erfüllt werden, einschließlich wiederholter Inaktivitätsmuster oder eines Verstoßes gegen den Verhaltenskodex.
Ein Vorschlag zur Herabstufung oder Entfernung eines Mitwirkenden kann während eines Maintainer-Meetings von einem Teilnehmer eingebracht werden. Der Teilnehmer liefert unterstützende Informationen für den Antrag auf Herabstufung oder Entfernung. Nach der Diskussion stimmen die Maintainer und Community Manager über das Thema ab, um eine Entscheidung zu treffen.
Das Entfernen inaktiver Mitwirkender schützt das Projekt und seine Lieferergebnisse und eröffnet neue Möglichkeiten für andere Mitwirkende, sich zu engagieren.
Wir definieren Inaktivität als:
- Keine Beiträge zum Projekt für mindestens sechs Monate.
- Keine Antwort auf Kommunikation für mindestens drei Monate.
Inaktivität schadet dem Projekt; es kann zu unerwarteten Verzögerungen, Abwanderung von Mitwirkenden und Vertrauensverlust in das Projekt führen. Mitwirkende müssen aktiv sein, um ein Beispiel zu geben und Engagement für das Projekt zu zeigen.
Bitte kommunizieren Sie mit dem Community-Team, um eine Herabstufung oder Entfernung zu vermeiden, sollten sich Ihre Zeitverpflichtungen ändern; stattdessen können Sie proaktiv für eine Weile zurücktreten oder in den Emeritus-Status wechseln.
Teams
Wir verwalten Teams mit der GitHub-Teams Funktion. Wenn Sie einem Team hinzugefügt werden, bedeutet das, dass Sie Ihre Absicht bekundet haben, sich näher am Projekt zu beteiligen. Das bedeutet auch, dass Sie einige zusätzliche Verantwortlichkeiten und Rechte haben, wie unten erläutert:
-
Eine Person in einem Team wird häufig in die CODEOWNERS Datei für ihre jeweiligen Interessengebiete aufgenommen.
-
Wenn ein Pull Request Dateien in Ihrem Verantwortungsbereich berührt, basierend auf der CODEOWNERS Datei, werden Sie automatisch als Reviewer für einen Pull Request hinzugefügt, indem GitHubs Lastverteilungsalgorithmus verwendet wird.
-
Mitglieder eines Teams haben einen höheren Repository-Zugriff. Repository-Berechtigungen werden nur auf diejenigen Repositories zugewiesen, in denen ein Mitglied Zugriff benötigt.
Die Teams in der MDN GitHub Organisation umfassen:
-
@Core
: Kernteam der MDN Web Docs -
@mdn-community-engagement
: Personen, die für das Engagement der Community in unseren Repositories 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 Open Web Docs Non-Profit-Organisation -
@sre
: Site Reliability Engineers, die MDN Web Docs unterstützen -
@yari-content
: Das übergreifende Team für alle MDN Web Docs Inhalte-Reviewer- Es gibt ein Unterteam für die verschiedenen Themenbereiche — Barrierefreiheit, Add-ons, CSS, HTML, HTTP, JavaScript, SVG, Web API und WebAssembly. Zum Beispiel gibt es
@yari-content-css
und@yari-content-svg
. - Es gibt auch Unterteams für verschiedene Sprachen — brasilianisches Portugiesisch, Chinesisch, Französisch, Japanisch, Koreanisch, Russisch und Spanisch. Zum Beispiel gibt es
@yari-content-fr
und@yari-content-ko
.
- Es gibt ein Unterteam für die verschiedenen Themenbereiche — Barrierefreiheit, Add-ons, CSS, HTML, HTTP, JavaScript, SVG, Web API und WebAssembly. Zum Beispiel gibt es
Um Mitglied eines Teams zu werden, müssen Sie:
- Zustimmen, sich an unsere Community-Teilnahmerichtlinien zu halten.
- Mozillas Commit-Zugangsanforderungen akzeptieren.
- Die Zwei-Faktor-Authentifizierung (2FA) auf Ihrem GitHub-Konto einrichten.
Kontaktieren Sie das MDN-Team
Für Anfragen und Feedback wenden Sie sich bitte an mdn-web-docs-community (at) mozilla (.com).