Erste Schritte mit den MDN Web Docs
Wir sind eine offene Gemeinschaft von Entwicklern, technischen Schreibern und Lernenden, die Ressourcen für ein besseres Web erstellen, unabhängig von Marke, Browser oder Plattform. Jeder kann beitragen, und jeder, der einen Beitrag leistet, hat Einfluss auf Millionen von Lesern. Erfahren Sie, wie Sie beitragen und Innovationen im Open Web vorantreiben können.
Wie kann ich helfen?
Es gibt verschiedene Möglichkeiten, wie Sie zu MDN beitragen können, abhängig von Ihren Fähigkeiten und Interessen. Deshalb geben wir zu jeder Aufgabe eine kurze Beschreibung und die ungefähre Dauer an, die jede Art von Aufgabe normalerweise benötigt. Wenn Sie unsicher sind, was Sie tun sollen, können Sie jederzeit in einem unserer Kommunikationskanäle um Hilfe bitten.
Wir haben ein Aufgabenboard für Beitragende erstellt, um Ihnen zu helfen, Möglichkeiten zur Mitwirkung zu finden, die das Projekt sinnvoll beeinflussen. Das Board bietet eine Übersicht und separate Ansichten für spezifische Beitragsarten. Beachten Sie, dass unser kleines, aber starkes Doku-Team dieses Repository pflegt. Um unsere Kapazitäten zu schonen, werden themenfremde Gespräche geschlossen.
Was benötige ich, um loszulegen?
Um beizutragen, benötigen Sie ein GitHub-Konto. Wenn Sie noch keins haben, registrieren Sie sich bitte für ein Konto, bevor Sie fortfahren. Wenn Sie neu bei GitHub sind, empfehlen wir Ihnen, die folgenden kostenlosen, selbstgesteuerten Kurse und das von GitHub angebotene Lesematerial zu nutzen. Mit diesem Wissen können Sie sich auf Ihre Beiträge konzentrieren, ohne gleichzeitig ein neues Tool lernen zu müssen.
Hinweis: Der Kurs "Einführung in GitHub" sollte ausreichen, um loszulegen. Sie können jederzeit weitergehen und später zu den anderen Dokumenten zurückkehren.
Wir empfehlen auch, das folgende Lernmaterial zu lesen:
- Grundsätzliches Verhalten in Open-Source-Projekten: Wenn Sie noch nie zu einem Open-Source-Projekt beigetragen haben, empfehlen wir Ihnen, dieses Dokument zu lesen.
- Webentwicklung lernen: Wenn Sie neu bei HTML, CSS, JavaScript sind, haben wir einige großartige Inhalte, um Ihnen den Einstieg zu erleichtern.
- Tiefes Eintauchen in die Zusammenarbeit mit Pull-Requests
Einige schreibspezifische Beiträge erfordern ein angemessenes Verständnis der englischen Sprache. Machen Sie sich jedoch keine Sorgen, wenn Ihre Grammatik nicht perfekt ist: Wir haben ein Team von Leuten, das Ihre Texte überprüft und verbessert. Wir brauchen Ihr technisches Fachwissen, und wir helfen Ihnen dabei, Ihr Englisch zu verbessern, um es zu veröffentlichen.
Wahl der Aufgabe und Einstieg
Sobald Sie sich entschieden haben, welche Art von Aufgabe Sie bearbeiten möchten, ist es an der Zeit, zum Aufgabenboard für Beitragende zu gehen, ein Problem auszuwählen und uns durch Kommentieren des Problems und Markieren des Teams @mdn/community zu informieren. Jemand aus dem Team wird mit Kommentaren, Hinweisen oder Anleitungen antworten.
Stellen Sie sicher, dass Sie nicht an etwas arbeiten, das bereits in Bearbeitung ist - es kann frustrierend sein, Arbeit zu duplizieren oder zu verlieren. Im Zweifelsfall stellen Sie Fragen zum Problem.
MDN Web Docs ist ein komplexes Projekt mit vielen beweglichen Teilen. Es ist eine gute Idee, sich mit den verschiedenen Code-Repositories vertraut zu machen.
Möglichkeiten, beizutragen
Hier ist eine Liste von Möglichkeiten, wie Sie zu den MDN Web Docs beitragen können:
- Arbeiten an gutem Erste-Schritte-Problemen
- Überprüfung von Pull-Requests
- Unterstützung von Anfängern in unserer Community
- Hilfe bei der Übersetzung der MDN Web Docs
- Hilfe bei der Behebung bekannter Backend-Probleme und bekannter Frontend-Probleme
- Hilfe, um Browser-Kompatibilitätsdaten auf dem neuesten Stand zu halten
Beiträge
Wenn Sie beitragen, stimmen Sie zu, Ihre Beiträge unter der Attribution-ShareAlike-Lizenz (oder einer anderen Lizenz, die speziell für die von Ihnen bearbeitete Seite angegeben ist) verfügbar zu machen. Zusätzlich sind Codebeispiele unter Creative Commons CC-0 (eine Widmung an die Gemeinfreiheit) verfügbar.
Wenn Sie Fragen oder Bedenken zu den hier besprochenen Themen haben, kontaktieren Sie uns bitte über unsere Kommunikationskanäle.