Non-Code-Beiträge zu Open Source
(github.com/readme)Non-Code-Beiträge sind der Schlüssel zum Erfolg von Open Source
- Die Mathematiklehrerin Sarah Rainsberger hatte nicht vor, freiwillig Open-Source-Mitwirkende zu werden, begann jedoch beim Neuaufbau der Website ihres Chors, JavaScript und Webentwicklung zu lernen.
- Bei der Nutzung des Frontend-Frameworks Astro steuerte sie dem Projekt eine kleine Codeänderung in Form einer Konfigurationsdatei bei, beteiligte sich an der Community und übernahm die Rolle, neue Astro-Nutzer zu unterstützen.
- Rainsberger ist heute Teil der Kern-Maintainer-Gruppe von Astro, arbeitet jedoch kaum an der Codebasis und konzentriert sich vor allem auf die Dokumentation sowie darauf, anderen beim Lernen von Astro zu helfen.
Wichtige Non-Code-Arbeiten in Open-Source-Projekten
- Open-Source-Projekte benötigen neben dem Schreiben von Code auch Dokumentation, Lokalisierung, Marketing, Grafikdesign, Testing, Community-Management und Release-Management.
- Die Bedeutung von Non-Code-Beiträgen ist sehr groß; je komplexer ein Projekt ist, desto mehr Dokumentation, Tutorials und Support werden benötigt, damit der Code nützlich wird.
- Grafikdesign, Branding und Outreach dienen als Signale für die Gesundheit und Seriosität eines Projekts und können dazu beitragen, dass andere Projekte oder Unternehmen es als Abhängigkeit nutzen.
Warum man mit Non-Code-Beiträgen beginnen sollte
- Non-Code-Beiträge bieten Menschen, die sich für Rollen ohne Programmierung interessieren, etwa in technischer Kommunikation, Grafikdesign oder User Experience Design, die Möglichkeit, ein Portfolio aufzubauen.
- Auch Programmierer profitieren davon, ihre Schreib- und Kommunikationsfähigkeiten zu schärfen, was beim Wechsel in Rollen wie Developer Relations oder Produktmanagement helfen kann.
- Open-Source-Projekte bieten Menschen aller Kenntnisstufen die Möglichkeit zur Mitarbeit, und ohne ein tiefes Verständnis des Projekts ist es schwierig, sinnvolle Code-Beiträge zu leisten.
Non-Code-Mitwirkende finden und Wertschätzung zeigen
- Für Maintainer ist es am besten, Mitwirkende zu finden, indem sie gezielt nach bestimmten Aufgaben fragen; außerdem hilft es, eine Community aufzubauen und Issues mit Tags wie "Hilfe gesucht" und "Good First Issue" anzulegen.
- Mentoring ist eine der besten Methoden, um Mitwirkende zum Erfolg zu führen, und Non-Code-Mitwirkende wertzuschätzen und sichtbar anzuerkennen hilft dabei, bestehende Mitwirkende zu motivieren und neue anzuziehen.
Meinung von GN⁺
- Entscheidend ist, dass der Erfolg von Open-Source-Projekten vielfältige Beiträge erfordert, die weit über das reine Schreiben von Code hinausgehen. Das ist ein wesentlicher Faktor für die Nachhaltigkeit und das Wachstum eines Projekts.
- Non-Code-Beiträge eröffnen auch nichttechnischen Menschen die Möglichkeit, sich an Open Source zu beteiligen, und helfen zugleich beim Aufbau technischer Fähigkeiten.
- Dieser Artikel kann Menschen inspirieren, die sich für die Open-Source-Community interessieren, und ihnen helfen, Wege zu finden, mit ihren eigenen Fähigkeiten zur Community beizutragen.
6 Kommentare
Das ist zwar eine etwas andere Geschichte, aber vor Kurzem hat jemand ein Tutorial dazu veröffentlicht, einen PR für die README-Datei von Express.js einzureichen, woraufhin Hunderte bedeutungsloser PRs eingegangen sind.
Pull requests · expressjs/express
Eine Belastung.. schnief
Das sind ja über 100 PRs, krass.
Ich war kurz verwirrt, wie man mit „Barcode“ beitragen soll, aber … haha
So gesehen kann eine ausführliche Dokumentation durchaus ein zweischneidiges Schwert sein.
Es könnte auch Fälle geben, in denen Dokumentation und Screenshots so detailliert werden, dass Entwickler sich nicht zutrauen, die Doku zu aktualisieren, und deshalb darauf verzichten, Verbesserungen weiterzuentwickeln..
Es ist („Nicht-“-)Code)
Hacker-News-Kommentar
Als Autor/Betreuer kleiner Bibliotheken kann ich bestätigen, dass die Handbücher ohne externe Beiträge nicht annähernd so gut wären wie heute. Handbücher tragen wesentlich zur Nutzbarkeit eines Projekts bei.
Wünsche an Open-Source-Projekte:
Dokumentation, Assets usw. sind in Open Source wichtig, können aber auch Nicht-Entwicklern Macht geben und ein Projekt ruinieren.
Für den Community-Aufbau ist es gut, Chat-Plattformen wie Discord, Gitter und Slack zu nutzen.
Aus meiner Erfahrung in der WordPress-Community denke ich, dass die frühe Dokumentation und die starke Dokumentation im Codex erheblich zum Wachstum von WordPress beigetragen haben.
Mein größter Wunsch an Open-Source-Projekte ist, dass Menschen sie nutzen und in irgendeiner Form festhalten, was sie damit gemacht haben.
Ich bin mir nicht sicher, ob Nicht-Code-Beiträge das Erfolgsgeheimnis eines Projekts sind, stimme aber zu, dass sie sehr wichtig sind.
Beim Start eines Open-Source-Projekts gibt es die Erwartung, dass zehnmal mehr Engineers die Software nutzen werden als Engineers tatsächlich Code dafür schreiben.
Wenn nichttechnische Menschen ein Projekt verstehen und darin Wert sehen, ist das ein guter Indikator für den Erfolg des Projekts.
Dokumentation ist wichtig, wenn ein Produkt vom Stadium, in dem es von Fans genutzt wird, obwohl es kaum bekannt ist, in die Phase übergeht, in der es mehr Nutzer finden muss.