MDN Web Docs Rollen und Teams
Der Erfolg und das Wachstum des MDN Web Docs Projekts ist größtenteils unserer Gemeinschaft von Mitwirkenden zu verdanken. Einige Mitwirkende haben sich verpflichtet, einen Teil ihrer Zeit für die täglichen Aufgaben bei der Verwaltung der MDN Web Docs zu verwenden. Änderungen an der Seite, einschließlich Wartungsaufgaben, werden von Angestellten, Auftragnehmern und einem Netzwerk von Partnern durchgeführt, die alle der Gesundheit, dem Wachstum und der Wartung der MDN Web Docs gewidmet sind. Das Projekt stützt sich stark auf Rollen und Teams in der MDN-Organisation auf GitHub, um die Änderungen dieser verschiedenen Gruppen zu verwalten und zu integrieren. Eine Liste der Organisationsmitglieder kann hier gefunden werden.
Die Beiträge der Gemeinschaft helfen diesem Open-Source-Projekt erheblich. Mitwirkende können ihre Arbeit an den MDN Web Docs nutzen, um ihre Schreib-, technischen und Kooperationsfähigkeiten sowie die Fähigkeit, mit Menschen aus verschiedenen Hintergründen zu arbeiten, unter Beweis zu stellen. Dieser Abschnitt beschreibt die Rollen, die Sie beim freiwilligen Engagement im MDN Web Docs Projekt übernehmen können.
Rollen
Im MDN Web Docs Projekt können Sie die Rolle eines Mitwirkenden, eines Organisationsmitglieds, eines Wartenden oder eines Eigentümers übernehmen. Der Fortschritt von einer Rolle zur nächsten ist ein Schritt-für-Schritt-Weg. Mit zunehmender Verantwortlichkeit können Sie mehr als eine Rolle gleichzeitig ausüben. Rollen wie eingeladener Experte können direkt erlangt werden, wenn Sie in einem bestimmten Bereich Fachkenntnisse nachgewiesen haben.
Unabhängig von der Rolle, die Sie in diesem Projekt übernehmen, sind Sie immer ein Mitwirkender. Ein Mitwirkender ist die Grundrolle und alle anderen Rollen bauen auf ihr auf. So müssen Sie, während Sie in irgendeiner Kapazität an diesem Projekt arbeiten, die Anforderungen der Rolle des Mitwirkenden erfüllen.
Mitwirkender
Mitwirkende, oder Teilnehmer der Gemeinschaft, tragen mit ihrer Zeit, ihren Fähigkeiten, Meinungen und Ideen zum Projekt bei. Mitwirkende arbeiten direkt am Projekt und tragen zur Wertschöpfung bei. Neben dem Schreiben und Testen von Code umfassen die Beiträge das Erstellen und Aktualisieren von Dokumentationen, Recherchetätigkeiten, Fehlerbeseitigungen und die Unterstützung anderer Gemeinschaftsmitglieder.
Abhängig von der Häufigkeit Ihrer Beiträge können Sie jemand sein, der gelegentlich beiträgt, oder ein aktiver Mitwirkender. Wenn Sie eine große Auswirkung auf das Projekt zeigen, können Sie als Spotlight-Mitwirkender nominiert oder zu einem Organisationsmitglied befördert werden.
Wenn Sie neu hier sind und Mitwirkender werden möchten, schauen Sie sich unseren Beitragsleitfaden und die Repositories in der MDN GitHub Organisation an.
Als Mitwirkender können Sie an folgenden Aktivitäten teilnehmen:
- Teilnahme an Gemeinschaftsdiskussionen auf den Kommunikationskanälen.
- Mithelfen anderer Mitwirkender mit ihren Pull-Requests und Problemen oder Mentoring neuer Mitwirkender.
-
Einreichen von Fehlerberichten. Schauen Sie sich die Art der Probleme an, die Sie eröffnen können im
content
-Repository von MDN. Wenn Sie einen Plattformfehler bemerken, können Sie ein Problem eröffnen imyari
-Repository von MDN. - Kommentieren von Problemen, um Gespräche in Richtung einer fruchtbaren Lösung zu lenken.
- Bearbeiten offener Probleme (zum Beispiel im
content
-Repository content/issues) durch das Einreichen von Pull-Requests. - Teilnahme an Gemeinschaftsveranstaltungen.
- Unterstützung bei der Förderung des MDN-Projekts.
Erforderlichkeiten:
Um Mitwirkender zu sein, müssen Sie:
- Mozillas Verhaltenskodex folgen.
- Beitragsrichtlinien einhalten (sehen Sie sich die
CONTRIBUTING.md
-Datei in jedem Repository an; zum Beispiel sind dies die Beitragsrichtlinien für dasmdn/content
-Repository).
Privilegien:
Mitwirkende genießen die folgenden Privilegien:
- Einladungen zu Veranstaltungen für Mitwirkende.
- Berechtigung, ein Organisationsmitglied zu werden.
Organisationsmitglied
Organisationsmitglieder sind etablierte Mitwirkende, die regelmäßig am MDN Web Docs Projekt teilnehmen und dazu beitragen. Sie sollen im Interesse des Projekts handeln.
Erforderlichkeiten:
Um ein Organisationsmitglied zu sein, müssen Sie eine oder mehrere der folgenden Anforderungen erfüllen:
- Mindestens zwei Pull-Requests geöffnet und gemergt haben, die zwei oder mehr Probleme lösen.
- Mindestens zwei Monate zu MDN Web Docs Projekten beigetragen haben.
- Aktiv zu mindestens einem Projektbereich beigetragen haben.
Die folgenden zwei Anforderungen sind obligatorisch:
- Aktives Zwei-Faktor-Authentifizierung für Ihr GitHub-Konto.
- Aktivierte signierte Commits.
Privilegien:
Organisationsmitglieder haben Privilegien auf Organisationsebene auf GitHub.
Wartender
Wartende sind etablierte Mitwirkende, die für eines oder mehrere Projekte bei MDN verantwortlich sind. Sie sollen an Entscheidungen über die Richtlinien und Prioritäten des Projekts teilnehmen. Sehen Sie den Prozess, um jemanden als Wartenden zu nominieren.
Als Wartender beteiligen Sie sich an folgenden Aktivitäten:
- Bestimmen der Prioritäten für das Projekt, für das Sie verantwortlich sind.
- Teilnahme an Gemeinschaftstreffen.
- Mentoring neuer und bestehender Mitwirkender in allen anderen Rollen.
- Basierend auf dem Fähigkeitenprofil: Vorschläge, Genehmigungen oder Implementierungen in Ihrem Projektbereich:
- Verbesserungen am Code und an der Infrastruktur
- Verbesserungen des Inhalts
- Prozessverbesserungen
Erforderlichkeiten:
Um berechtigt zu sein, ein Wartender zu werden, müssen Sie eine oder mehrere der folgenden Anforderungen erfüllen:
- Erfahrung als eingeladener Experte für mindestens sechs Monate gesammelt haben.
- Ein breites Wissen über das Projekt in mehreren Bereichen gezeigt haben.
- Die Fähigkeit demonstriert haben, zum Wohl des Projekts selbstständige Entscheidungen treffen zu können, unabhängig vom Einfluss anderer Mitglieder.
- Die Qualität gezeigt haben, andere Mitwirkende zu betreuen.
- Einwilligung, mindestens 16 Stunden pro Monat an dem Projekt zu arbeiten.
- An dem Gemeinschaftstreffen teilgenommen haben, das alle zwei Monate stattfindet.
Hinweis: Wenn Sie denken, dass jemand für diese Rolle geeignet ist, können Sie einen Wartenden nominieren.
Privilegien:
Wartende haben die Berechtigung, Pull-Requests zu genehmigen und zu mergen.
Eigentümer
Eigentümer haben umfassende Berechtigungen, um Benutzer und GitHub-Teams zu verwalten, den Zugriff auf Repositories in der MDN-Organisation zu verwalten, Repositoriyeinstellungen zu pflegen und in Produktion zu überführen. Eigentümer sind an alle Anforderungen anderer Mitwirkendenrollen gebunden.
Hinweis: Die Rolle eines Eigentümers ist derzeit auf Mozilla-Mitarbeiter beschränkt.
Erforderlichkeiten:
Zusätzlich zu den Verantwortlichkeiten anderer Mitwirkendenrollen haben Eigentümer folgende Verantwortlichkeiten:
- Einhaltung und Durchsetzung der MDN Teamnormen, einschließlich der Communityteilnahme-Richtlinien und Mozilla-Richtlinien.
- Befolgung der MDN Organisationsrichtlinien und Vorbildfunktion.
- Vorschlagen, Dokumentieren und Implementieren neuer Richtlinien durch den Pull-Request-Prozess.
- Nachverfolgen und Beitragen zu Problemen und Diskussionen innerhalb der MDN-Organisation.
- Sicherstellen, dass ein Problem oder Pull-Request innerhalb einer Woche Feedback von einem oder mehreren Mitgliedern erhält.
- Archivieren oder Löschen ungewarteter Repositories.
- Besprechen von GitHub-Funktionen, Auswählen der zu nutzenden und Dokumentierung der Entscheidungen.
Privilegien:
Eigentümer können:
- Organisationseigentümer und -mitglieder bei Bedarf hinzufügen und entfernen.
- Mitarbeiter für bestimmte Repositories nach Bedarf hinzufügen und entfernen.
- Repositories nach Bedarf hinzufügen (als neue Projekte oder Übertragungen).
Zusammenfassung der Rollen
Rolle | Erforderlichkeiten | Privilegien |
---|---|---|
Mitwirkender | Befolgung des Verhaltenskodexes und der Beitragsrichtlinien | - Einladungen zu Mitwirkendenveranstaltungen - Berechtigung, ein Organisationsmitglied zu werden |
Organisationsmitglied | - 2FA für GitHub-Konto aktivieren - Signierte Commits aktivieren Eine oder mehrere: - Lösung von zwei oder mehr Problemen - Mindestens zwei Monate lang Beiträge leisten - Aktiver Beitrag in einem Projektbereich |
Zugriffsrechte auf Organisationsebene |
Wartender | Eine oder mehrere: - Eingeladener Experte für mindestens sechs Monate - Wissen über mehrere Projektbereiche - Im Gesamtinteresse des Projekts handeln - Andere Mitwirkende betreuen - Mindestens 16 Stunden pro Monat am Projekt arbeiten - Teilnahme an Gemeinschaftstreffen |
Genehmigung und Merging von Pull-Requests |
Eigentümer | Auf Mozilla-Mitarbeiter beschränkt | - Verwaltung des Zugriffs verschiedener Rollen auf verschiedene Repositories - Repositories und Projekte hinzufügen oder archivieren |
Besondere Rollen
Einige Mitwirkendenrollen haben differenzierte Verantwortlichkeiten und spezielle Eignungsbedingungen. Dazu zählen Spotlight-Mitwirkender, eingeladener Experte und Gemeinschaftsmanager.
Spotlight-Mitwirkender
Spotlight-Mitwirkende sind Personen, die mit ihren Beiträgen zu den MDN Web Docs über sich hinausgewachsen sind. Ihre Beiträge sind in Form von Pull-Requests zur Verbesserung des Projekts, Unterstützung der Gemeinschaftsmitglieder auf verschiedenen Kommunikationskanälen oder Lernforen oder Feedback zu GitHub-Problemen und Pull-Requests.
Wir präsentieren jeden Monat einen Spotlight-Mitwirkenden auf der MDN-Website. Sehen Sie sich den Prozess an, um jemanden als Spotlight-Mitwirkenden zu nominieren.
Eingeladener Experte
Eingeladene Experten haben eine Erfolgsgeschichte bei MDN für ihre Beiträge, Teilnahme an Diskussionen und Bewertungen oder haben nachweislich Kenntnisse in einem bestimmten Fachbereich. Eingeladene Experten sind verantwortlich für einen spezifischen Themenbereich oder eine Komponente des MDN-Projekts. Sie sind verantwortlich für die Überprüfung und Genehmigung von Pull-Requests in ihrem Themen- oder Projektbereich, Beantwortung technischer Fragen und die allgemeine Gesundheitsförderung ihres speziellen Projekts. Sehen Sie sich den Prozess an, um jemanden als eingeladenen Experten zu nominieren.
Zusätzlich zu den Verantwortlichkeiten eines Organisationsmitglieds sind eingeladene Experten verantwortlich für:
- Einhaltung des Überprüfungsleitfadens.
- Überprüfung von Pull-Requests in ihrem Themenbereich.
- Unterstützung anderer Mitwirkender, Rezensenten zu werden.
Eingeladene Experten werden automatisch für die Überprüfung hinzugezogen, wenn Pull-Requests in ihrem Themenbereich geöffnet werden. Wenn es mehr als einen Experten in einem Themenbereich gibt, werden sie mithilfe einer Lastausgleichsstrategie Pull-Requests zugewiesen.
Erforderlichkeiten:
Um als eingeladener Experte in Betracht gezogen zu werden, müssen Sie eine oder mehrere der folgenden Anforderungen erfüllen:
- Nachgewiesene inhaltliche Kenntnisse in einem bestimmten Themenbereich.
- Verpflichtung, für ihren zugewiesenen Themenbereich verantwortlich zu sein.
- Unterstützung neuer und gelegentlicher Mitwirkender und geholfen, Pull-Requests upfit for merging zu machen.
- Teilnahme an dem Gemeinschaftstreffen, das alle zwei Monate stattfindet.
Privilegien:
Eingeladene Experten werden zum eingeladene Experten Team und zum passenden Themen- oder Projektteam hinzugefügt. Eingeladene Experten können:
- Zugriff auf das benötigte Repository für Commits und Pull-Request-Genehmigungen und -Merges haben.
- Andere Mitglieder als eingeladene Experten empfehlen und dafür stimmen.
- An wöchentlichen MDN Web Docs Redaktionstreffen teilnehmen.
Gemeinschaftsmanager
Gemeinschaftsmanager haben in vielerlei Hinsicht eine besondere Rolle. Gemeinschaftsmanager teilen viele der gleichen Verantwortlichkeiten wie ein Wartender. Zusätzlich haben Gemeinschaftsmanager die folgenden Verantwortlichkeiten:
- Bearbeitung von Berichten über Verstöße gegen unseren Verhaltenskodex, der Mozillas Communityteilnahme-Richtlinien entspricht, und Entscheidung über geeignete Maßnahmen.
- Organisation und Durchführung von Gemeinschaftsveranstaltungen.
- Organisation von gemeinschaftlichen Projektbesprechungen.
- Bestimmen von Medienstrategien zur Förderung des MDN-Projekts.
- Definieren und Implementieren der Benutzererfahrung beim Onboarding von Mitwirkenden.
- Einweisung neuer Mitwirkender und Nutzer.
- Sicherstellen der Gesundheitsförderung und des Wohlbefindens des MDN-Projekts und aller Teilnehmer.
- Identifizierung und Unterstützung bei der Implementierung von Automatisierungen zur Verbesserung der Projektnachhaltigkeit.
- Pflegen und Sicherstellen einer gesunden Beziehung zu Mitwirkenden und Partnern.
- Unterstützung bei der Problemanalyse und Pull-Request-Überprüfung, wo geeignet.
- Überwachung aller Kommunikationskanäle.
- Hervorhebung von Mitwirkenden, die außergewöhnliche Arbeit geleistet und/oder Engagement für das MDN-Projekt gezeigt haben.
Prozesse
Einen Wartenden nominieren
Siehe, wer ein Wartender sein kann.
Um jemanden als Wartenden zu nominieren, öffnen Sie ein Problem auf GitHub:
- Gehen Sie auf den
Issues
Tab im Repositorymdn/mdn
und klicken Sie auf die Schaltfläche New issue rechts. - Unter 'Nominate a maintainer' klicken Sie auf die Schaltfläche Get started.
- Füllen Sie das Formular mit den Details zu den Beiträgen der Person, die Sie nominieren, und reichen Sie das Formular ein.
Eine Spotlight-Mitwirkender nominieren
Siehe, wer ein Spotlight-Mitwirkender sein kann.
Um jemanden als Spotlight-Mitwirkender zu nominieren, öffnen Sie ein Problem auf GitHub:
- Gehen Sie auf den
Issues
Tab im Repositorymdn/mdn
und klicken Sie auf die Schaltfläche New issue rechts. - Unter 'Nominate a spotlight contributor' klicken Sie auf die Schaltfläche Get started.
- Füllen Sie das Formular mit den Details zu den Beiträgen der Person, die Sie nominieren, und reichen Sie das Formular ein.
Das MDN-Team wird sich mit der nominierten Person in Verbindung setzen, um ihre Informationen zu erhalten, die auf der Website unter "Contributor Spotlight" veröffentlicht werden sollen.
Einen eingeladenen Experten nominieren
Siehe, wer ein eingeladener Experte sein kann.
Um jemanden als eingeladenen Experten zu nominieren, öffnen Sie ein Problem auf GitHub:
- Gehen Sie auf den
Issues
Tab im Repositorymdn/mdn
und klicken Sie auf die Schaltfläche New issue rechts. - Unter 'Nominate an invited expert' klicken Sie auf die Schaltfläche Get started.
- Füllen Sie das Formular mit den Details zu den Beiträgen der Person, die Sie nominieren, und reichen Sie das Formular ein.
Zurücktreten oder Emeriti-Status beantragen
Das Leben geht weiter und Ihre Verpflichtungslevel als Mitwirkender könnten sich im Laufe der Zeit ändern. Abhängig von Ihrer Situation möchten Sie möglicherweise:
- Eine Pause vom Projekt einlegen.
- Auf eine weniger fordernde Rolle zurückgestuft werden.
- Sich vollständig vom Projekt zurückziehen (Emeriti-Status beantragen).
In all diesen Situationen fühlen Sie sich frei, Ihre Situation und aktuelle Verpflichtungsebenen mit dem MDN-Team zu besprechen.
Inaktive Mitwirkende degradieren oder entfernen
Ein Mitwirkender kann degradiert oder als Mitwirkender entfernt werden, wenn Verantwortungen und Anforderungen nicht erfüllt werden, einschließlich wiederholter Muster der Inaktivität oder eines Verstoßes gegen den Verhaltenskodex.
Die Degradierung oder Entfernung eines Mitwirkenden wird von einem Teilnehmer während eines Wartungsbesprechens vorgeschlagen. Der Teilnehmer liefert unterstützende Informationen für das Gesuch um Degradierung oder Entfernung. Nach der Diskussion stimmen Wartende und Gemeinschaftsmanager über die Angelegenheit ab, um eine Entscheidung zu treffen.
Das Entfernen inaktiver Mitwirkender schützt das Projekt und seine Ergebnisse und schafft auch Gelegenheiten für neue Mitwirkende, einzuspringen.
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, Mitwirkendenverlust und einem 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 Gemeinschaftsteam, um eine Degradierung oder Entfernung zu vermeiden, sollten sich Ihre Zeitverpflichtungen ändern; stattdessen können Sie proaktiv entscheiden, sich für eine Weile zurückzuziehen oder in den Emeriti-Status zu wechseln.
Teams
Wir verwalten Teams mithilfe der GitHub-Teams Funktion. Wenn Sie einem Team hinzugefügt werden, bedeutet dies, dass Sie Ihre Absicht kommuniziert haben, enger in das Projekt eingebunden zu sein. Dies bedeutet auch, dass Sie einige zusätzliche Verantwortlichkeiten und Rechte haben, wie unten erklärt:
-
Eine Person in einem Team wird normalerweise zur CODEOWNERS Datei für ihre jeweiligen Themenbereiche von Interesse hinzugefügt.
-
Wenn ein Pull-Request Dateien in Ihrem Verantwortungsbereich berührt, basierend auf der CODEOWNERS Datei, werden Sie anhand von GitHubs Lastverteilungsalgorithmus automatisch als Rezensent zu einem Pull-Request hinzugefügt.
-
Mitglieder eines Teams haben eine höherstufige Repository-Berechtigung. Repository-Berechtigungen werden nur auf diejenigen Repositories vergeben, auf die 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 Gemeinschaft in unseren Repositories verantwortlich sind -
@mdn-product
: Personen, die für das MDN Plus Produkt verantwortlich sind -
@localization-team-leads
: Personen, die unsere einzelnen Lokalisierungsteams leiten -
@OWD
: Mitwirkende der Open Web Docs Non-Profit-Organisation -
@sre
: Site-Reliability-Ingenieure, die MDN Web Docs unterstützen -
@yari-content
: Das Dachteam für alle MDN Web Docs Inhaltsreviewer- 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:
- Sich verpflichten, unsere Communityteilnahme-Richtlinien einzuhalten.
- Sich verpflichten, Mozillas Commit-Zugriffsanforderungen einzuhalten.
- Zwei-Faktor-Authentifizierung (2FA) auf Ihrem GitHub-Konto einrichten.
Kontakt das MDN-Team
Für Anfragen und Feedback kontaktieren Sie bitte mdn-web-docs-community (at) mozilla (.com).