Neue Richtlinien für Beiträge

Falls du von einem automatisch geschlossenen Issue/PR hierher verwiesen wurdest, bitte gerate nicht in Panik und fühl dich nicht abgewiesen. Meistens wird deine Arbeit früher oder später in Exercism einfließen, oder dein Problem wird gelöst. Wir freuen uns über Beiträge und ermutigen dazu, aber wir besprechen Dinge gern zuerst in unserem Forum, bevor es an den Code auf GitHub geht. Ein Thread im Forum bringt die Sache voran.

Im letzten Jahr haben wir damit experimentiert, Beiträge von Nicht-Maintainern einzuschränken, um unseren Core-Contributoren Zeit freizumachen und ihnen größere Verbesserungen an Tracks zu ermöglichen. Das hat ziemlich gut funktioniert. Verglichen mit 2022 wurden 2023 doppelt so viele neue Übungen hinzugefügt und dreimal so viele Syllabi erstellt. Der Wechsel der Vorgehensweise hat deutlich größere Beiträge ermöglicht und für weniger Frust und weniger Ablenkung bei unseren Core-Contributoren gesorgt.

Allerdings weiß ich auch, dass er bei neuen Contributoren für Frust gesorgt hat. Viele von ihnen möchten gern mithelfen, fühlen sich aber von unserem Beitragsprozess ausgebremst. Deshalb möchte ich heute ein paar neue (oder klargestellte) Richtlinien dafür vorstellen, wie wir in den nächsten Monaten mit Beiträgen umgehen wollen.

Die wichtigste Regel lautet: Wir besprechen Ideen, Bugs und Issues in unserem Forum, und die daraus entstehenden Codeänderungen besprechen wir auf GitHub (in PR-Reviews). Die zweite Regel lautet, dass wir alles erst besprechen und dann tun (außer Maintainer, die eigenständig arbeiten). In unserem Forum können Contributoren und Maintainer über alle Tracks hinweg Wissen und Erfahrungen zu einer Vielzahl von Sprachen und Ideen austauschen, ohne 300 verschiedene Repositories auf GitHub abonnieren und ihre Benachrichtigungen überfluten zu müssen.

Aktualisierte Richtlinien

Support erhalten

• Wenn du vor dem Lösen einer Übung nicht weiterkommst (z. B. bei der Installation der Kommandozeile, beim Ausführen von Tests oder bei der Logik bzw. den Anforderungen einer Übung), dann sind unsere Support-Kanäle die Kategorie „Exercism Support“ im Forum und der Channel #get-help auf unserem Discord-Server.
• Für Support-Anfragen nutzen wir weder GitHub noch E-Mail.
• Wenn du eine Übung gelöst hast, aber Fragen dazu hast, solltest du direkt auf Exercism um Mentoring bitten.

Bugs/Issues melden

• Alle Bugs/Issues sollten in unserem Forum gemeldet werden, wo viele verschiedene Leute helfen können, das Problem zu verstehen und zu lösen.
  • Wenn es um eine Sprache geht, nutze bitte die passende Kategorie Programming/xxx.
  • Wenn es sich um einen Bug auf der Website handelt, nutze bitte die Kategorie „Bugs & Feature Requests“.
• GitHub-Issues werden in der Regel automatisch geschlossen und die Person, die sie erstellt hat, wird ins Forum weitergeleitet (mit einem Ein-Klick-Link, um das eigene Issue zu kopieren und einzufügen, wie es derzeit der Fall ist).
• Track-Maintainer können den automatischen Issue-Schließer abschalten, aber der offizielle Weg führt weiterhin über das Forum.

Pull Requests öffnen

• Pull Requests sollten im Forum besprochen werden, bevor die Arbeit gemacht wird.
• Pull Requests von Nicht-Organisationsmitgliedern werden weiterhin automatisch geschlossen, aber oft wieder geöffnet, sobald die Arbeit im Forum besprochen wurde. Wenn die Idee hinter einem PR bereits genehmigt wurde, füge einfach einen Link zum PR im passenden Forum-Thread hinzu, und wir öffnen ihn wieder.
• Track-Maintainer können den automatischen PR-Schließer abschalten, aber wir empfehlen weiterhin, dass alle PRs zuerst im Forum besprochen werden.

Zusammenfassung

Unsere oberste Priorität bleibt es, die Zeit und die mentale Kapazität unserer Core-Contributoren zu schützen, ohne die Exercism nicht funktionieren kann. Aber wir wollen auch sicherstellen, dass Exercism ein Ort bleibt, an dem sich neue Leute ohne allzu abschreckende Hürden einbringen können, und an dem wir diese Leute ermutigen und dabei unterstützen, selbst Core-Contributoren zu werden!

Ich bin gespannt, wie sich diese Änderungen in den nächsten Monaten auf die Beiträge auswirken, die wir sehen. Mitte 2024 schauen wir uns alles noch einmal an.