134 lines
9.7 KiB
Markdown
134 lines
9.7 KiB
Markdown
|
<!-- do not translate this -->
|
||
|
|
| [Read these guidelines in other languages](/docs/i18n-languages) |
|
||
|
|
|-|
|
||
|
|
<!-- do not translate this -->
|
||
|
|
||
|
|
# Contribution Richtlinien
|
||
|
|
|
||
|
|
Hallo 👋!
|
||
|
|
|
||
|
|
freeCodeCamp.org wird dank vieler tausender Freiwilligen wie dir ermöglicht. Wir sind sehr dankbar für Deine Beiträge, und freuen uns, Dich hier willkommen zu heißen.
|
||
|
|
|
||
|
|
Wir setzen unseren ["Verhaltenskodex"](https://www.freecodecamp.org/code-of-conduct) streng durch. Nimm Dir einen Moment Zeit, ihn zu lesen. Er ist nur 196 Wörter lang.
|
||
|
|
|
||
|
|
Viel Spaß beim Mitwirken 🎉!
|
||
|
|
|
||
|
|
## Hier sind einige Wege, wie Du helfen kannst
|
||
|
|
|
||
|
|
Du kannst Dir einen beliebigen Bereich aussuchen, zu dem du etwas beitragen möchtest:
|
||
|
|
|
||
|
|
1. [Trage etwas zu dieser Open-Source-Codebase bei](#Trage-etwas-zu-dieser-Open-Source-Codebase-bei). Hilf dabei, die [Leitfaden-Artikel](https://guide.freecodecamp.org/) oder die [Coding Challenges](https://learn.freecodecamp.org/) zu bearbeiten, oder fixe Bugs auf der Lernplattform.
|
||
|
|
|
||
|
|
2. Hilf Campern in unserem [öffentlichen Forum](https://www.freecodecamp.org/forum/). [Beantworte ihre Programmierfragen](https://www.freecodecamp.org/forum/?max_posts=1) oder [oder gib ihnen Feedback zu ihren Programmierprojekten](https://www.freecodecamp.org/forum/c/project-feedback?max_posts=1).
|
||
|
|
|
||
|
|
3. Hilf uns, Untertitel zu unseren [YouTube-Kanal-Videos](https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ/videos) hinzuzufügen.
|
||
|
|
|
||
|
|
## Trage etwas zu dieser Open-Source-Codebase bei
|
||
|
|
|
||
|
|
Wir haben eine riesige Open-Source-Codebas, die aus tausenden von [Coding Challenges](https://learn.freecodecamp.org) und [Leitfaden-Artikeln](https://guide.freecodecamp.org) besteht.
|
||
|
|
|
||
|
|
Hierbei kannst Du uns helfen:
|
||
|
|
|
||
|
|
- [📝 Leitfaden-Artikel recherchieren, schreiben und aktualisieren](#leitfaden-artikel-recherchieren-schreiben-und-aktualisieren)
|
||
|
|
|
||
|
|
- [💻 Bugs in unseren Coding Challenges finden, aktualisieren und fixen](#bugs-in-unseren-coding-challenges-finden-aktualisieren-und-fixen)
|
||
|
|
|
||
|
|
- [🌐 Leitfaden-Artikel und Coding Challenges übersetzen](#leitfaden-artikel-und-coding-challenges-übersetzen)
|
||
|
|
|
||
|
|
- [🛠 Bugs auf der Lernplattform von freeCodeCamp.org fixen](#Bugs-auf-der-Lernplattform-von-freecodecamporg-fixen)
|
||
|
|
|
||
|
|
### Leitfaden-Artikel recherchieren, schreiben und aktualisieren
|
||
|
|
|
||
|
|
**Was sind Leitfaden-Artikel?**
|
||
|
|
|
||
|
|
Leitfaden-Artikel helfen Dir, ein technologisches Konzept schnell zu begreifen. Sie sind kurz und in einer klar verständlichen Sprache geschrieben, sodass Du sie lesen kannst, bevor Du zu tiefer gehenden Ressourcen weitergehst.
|
||
|
|
|
||
|
|
Hier findest du einen [Beispiel-Artikel zu HTML-Anchor-Elementen](https://github.com/freeCodeCamp/freeCodeCamp/blob/master/guide/english/html/elements/a-tag/index.md).
|
||
|
|
|
||
|
|
**Über was kann ich einen Artikel schreiben?**
|
||
|
|
|
||
|
|
Wir freuen uns über Deine Hilfe beim Schreiben dieser Artikel. Du musst kein Experte in einem Gebiet sein, um darüber zu schreiben - der komplette Leitfaden ist Open Source, d.h. auch wenn Du einen Fehler machst, wird ihn schlussendlich ein anderer Contributor korrigieren.
|
||
|
|
|
||
|
|
Um zu helfen, finde einen `Stub-Artikel` auf unser [Leitfaden-Webseite](https://guide.freecodecamp.org), schreibe den Artikel und öffne einen Pull Request, um den Stub mit Deinem Artikel zu ersetzen. Ein [Pull Request](https://help.github.com/articles/about-pull-requests/) ist ein Weg, um Änderungen vorzuschlagen. So können andere von Deinen Änderungen erfahren, sie prüfen und schließlich übernehmen.
|
||
|
|
|
||
|
|
Wenn Du keinen Stub zu dem Thema finden kannst, über das Du gerne schreiben würdest, kannst Du einen Pull Request öffnen, der den Stub anlegt und Deinen Artikel enthält.
|
||
|
|
|
||
|
|
Wenn Du dabei helfen willst, die Leitfaden-Artikel zu verbessern, kannst du [hier eine Anleitung finden](/docs/how-to-work-on-guide-articles.md).
|
||
|
|
|
||
|
|
### Bugs in unseren Coding-Challenges finden, aktualisieren und fixen
|
||
|
|
|
||
|
|
Alle unsere Coding Challenges werden von Mitgliedern unserer Community verwaltet, die Experten-Wissen von Freiwilligen wie Dir mitbringen.
|
||
|
|
|
||
|
|
Du kannst dabei helfen, sie zu erweitern und sie klarer zu formulieren. Du kannst die User Stories aktualisieren, um das Konzept besser zu erklären, und auch überflüssige entfernen. Ebenso kannst Du die Challenge-Tests verbessern, damit sie den eingereichten Code genauer testen.
|
||
|
|
|
||
|
|
Wenn Du daran interessiert bist, diese Coding Challenges zu verbessern, findest Du [hier eine Artikel dazu](/docs/how-to-work-on-coding-challenges.md).
|
||
|
|
|
||
|
|
### Leitfaden-Artikel und Coding Challenges übersetzen
|
||
|
|
|
||
|
|
Du kannst uns helfen, unsere Leitfaden-Artikel und unsere Coding Challenges in eine Sprache, die Du sprichst, zu übersetzen. Aktuell haben wir übersetzte Versionen in den folgenden Sprachen:
|
||
|
|
|
||
|
|
- [Chinese (中文)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/chinese)
|
||
|
|
- [Russian (русский)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/russian)
|
||
|
|
- [Arabic (عربى)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/arabic)
|
||
|
|
- [Spanish (Español)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/spanish)
|
||
|
|
- [Portuguese (Português)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/portuguese)
|
||
|
|
|
||
|
|
Wir würden uns sehr über Deine Hilfe beim Verbessern der Übersetzungen freuen. Millionen Menschen nutzen die englischsprachige Version von freeCodeCamp.org, und wir erwarten, dass Millionen Menschen mehr die übersetzten Versionen nutzen werden.
|
||
|
|
|
||
|
|
### Bugs auf der Lernplattform von freeCodeCamp.org fixen
|
||
|
|
|
||
|
|
Unsere Lernplattform läuft auf einem modernen JavaScript-Stack. Sie hat mehrere Komponenten, Tools und Bibliotheken, inklusive aber nicht limitiert auf Node.js, MongoDB, LoopBack, OAuth 2.0, React, Gatsby, Webpack, und mehr.
|
||
|
|
|
||
|
|
Grob gesagt haben wir
|
||
|
|
|
||
|
|
- einen Node.js basierten API-Server,
|
||
|
|
- eine Reihe von React basierten Client-Anwendungen und
|
||
|
|
- ein Skript, das wir verwenden, um unsere Frontend-Projekte zu evaluieren.
|
||
|
|
|
||
|
|
Um dazu beizutragen braucht man ein gewisses Verständnis von APIs, ES6-Syntax and eine Menge Neugier.
|
||
|
|
|
||
|
|
Im Wesentlichen erwarten wir eine grundlegende Vertrautheit mit einigen der erwähnten Technologien, Tools und Bibliotheken. Du musst allerdings keine Experte darin sein, um etwas beizutragen.
|
||
|
|
|
||
|
|
Bitte zögere nicht, uns Fragen auf den damit zusammenhängenden Issue Threads zu schicken, wir beantworten sie gerne. Wenn Du Dir nicht sicher bist, kannst Du Dich immer an Mrugesh Mohapatra [`@raisedadead`](https://github.com/raisedadead) oder Stuart Taylor [`@bouncey`](https://github.com/bouncey) von unserem Plattform-Development-Team wenden, um Dir hiermit zu helfen.
|
||
|
|
|
||
|
|
Wenn Du uns helfen möchtest, unsere Codebase zu verbessern, findest du hier eine Anleitung, [wie du freeCodeCamp lokal anlegst](/docs/how-to-setup-freecodecamp-locally.md).
|
||
|
|
|
||
|
|
## Häufig gestellte Fragen
|
||
|
|
|
||
|
|
**Wie kann ich einen Bug melden, der noch nicht dokumentiert wurde?**
|
||
|
|
|
||
|
|
Wenn Du denkst, dass Du einen Bug gefunden hast, lies zunächst den ["Hilfe, ich habe einen Bug gefunden"](https://forum.freecodecamp.org/t/how-to-report-a-bug/19543)-Artikel und folge den Anweisungen.
|
||
|
|
|
||
|
|
Wenn Du Dir sicher bist, dass es sich um einen neuen Bug handelt, kannst du ein neues GitHub-Issue erstellen. Stelle sicher, dass Du so viel Information wie möglich dazuschreibst, sodass wir den Bug nachvollziehen können. Wie haben ein vorgefertigtes Issue-Template, das Dir dabei hilft.
|
||
|
|
|
||
|
|
Bitte beachte, dass alle Issues, die nach Hilfe bei einer Coding Challenge fragen, geschlossen werden. Der Issue-Tracker ist ausschließlich für Probleme und Diskussionen, die sich auf die Codebase beziehen. Wenn Du Dir nicht sicher bist, [frag im Forum nach Hilfe](https://www.freecodecamp.org/forum), bevor Du einen Report machst.
|
||
|
|
|
||
|
|
**Wie kann ich ein Sicherheitsrisiko melden?**
|
||
|
|
|
||
|
|
Bitte erstelle keine GitHub-Issues für Sicherheitsrisiken. Schicke stattdessen eine E-Mail an `security@freecodecamp.org` und wir werden uns sofort darum kümmern.
|
||
|
|
|
||
|
|
**Ich hänge an etwas fest, das nicht in der Dokumentation beschrieben ist. Wie bekomme ich Hilfe?**
|
||
|
|
|
||
|
|
An den folgenden Orten kannst Du um Hilfe bitten:
|
||
|
|
|
||
|
|
- [Der "Contributor"-Bereich unseres öffentlichen Forums](https://www.freecodecamp.org/forum/c/contributors)
|
||
|
|
- [Unser öffentlicher Chatroom für Contributor auf Gitter](https://gitter.im/FreeCodeCamp/Contributors)
|
||
|
|
|
||
|
|
Wir helfen Dir sehr gerne beim Mitwirken an jeglichen Bereichen, die Dich interessieren. Stelle sicher, dass Du erst nach deiner Anfrage suchst, before Du eine neue anlegst. Sei höflich und geduldig. Unsere Community von Freiwilligen und Moderatoren ist immer da, um Dich bei Deinen Anliegen zu führen.
|
||
|
|
|
||
|
|
**Ich bin ein GitHub/Open-Source-Neuling:**
|
||
|
|
|
||
|
|
Lies unseren [Wie wirke ich an Open-Source-Projekten mit-Artikel](https://github.com/freeCodeCamp/how-to-contribute-to-open-source).
|
||
|
|
|
||
|
|
**Was bedeuten die unterschiedlichen Label, die auf Issues getaggt sind?**
|
||
|
|
|
||
|
|
Unsere Community-Moderatoren [sichten](https://en.wikipedia.org/wiki/Software_bug#Bug_management) Issues und Pull Requests basierend auf ihrer Priorität, Schwere und anderen Faktoren. [Hier findest Du das komplette Glossar zu den Bedeutungen](https://github.com/freecodecamp/freecodecamp/labels).
|
||
|
|
|
||
|
|
Du solltest durch die **`Help Wanted`** oder **`first timers welcome`** Issues schauen, um einen schnellen Überblick über das, woran Du arbeiten könntest, zu gewinnen. Diese sind frei zur Bearbeitung und Du musst nicht nach Erlaubnis fragen, um daran zu arbeiten.
|
||
|
|
|
||
|
|
Wenn diese Issues unklar sind bezüglich was getan werden muss, zögere nicht, Fragen in den Kommentaren zu stellen.
|
||
|
|
|
||
|
|
**Ich habe einen Rechtschreibfehler gefunden, soll ich ein Issue öffnen, bevor ich einen Pull Request machen kann?**
|
||
|
|
|
||
|
|
Für Rechtschreibfehler und andere Formulierungsänderungen kannst Du direkt einen Pull Request erstellen, ohne vorher ein Issue zu öffnen. Issues sind eher für die Diskussion größerer Probleme, die sich mit dem Code und anderen strukturellen Aspekten des Curriculums beschäftigen.
|