Code veröffentlichen & bei FARMWISSEN mitmachen
Einleitung:
Dieses Tutorial erklärt, wie du dich an Projekten in der FARMWISSEN-GitHub-Organisation beteiligen kannst. Es zeigt den Weg vom Nutzen bestehender Software über das Melden von Bugs und Features bis hin zur aktiven Mitarbeit und der Veröffentlichung eigener Projekte innerhalb der Organisation.
Dieser Teil richtet sich an alle, die FARMWISSEN-Projekte nutzen möchten, ohne selbst aktiv zu programmieren. Du lernst, wo du den Code findest, wie du ihn verwendest und wie du Feedback in Form von Bugmeldungen oder Feature-Vorschlägen einbringst.
| Alle FARMWISSEN-Projekte werden zentral auf GitHub bereitgestellt. Dort findest du Software, Tools und Beispielprojekte aus Forschung und Praxis. |  |
| Öffne die FARMWISSEN-Organisation auf GitHub und wähle ein Projekt aus, das für dich relevant ist. |  |
| Lies zunächst die README-Datei. Dort wird beschrieben, wofür das Projekt gedacht ist und wie es genutzt werden kann. |  |
| Wenn bei der Nutzung eines Projekts ein Fehler auftritt, kannst du diesen als Bug melden. Öffne dazu im Repository den Bereich Issues und klicke auf New Issue. |   |
| Beschreibe den Fehler möglichst konkret und ergänze bei Bedarf Screenshots oder Fehlermeldungen. |  |
| Neben Bugs kannst du auch Ideen für neue Funktionen oder Verbesserungen vorschlagen. Erstelle dafür ein neues Issue und beschreibe deine Idee praxisnah. |  |
Auch ohne Programmierkenntnisse kannst du aktiv zur Weiterentwicklung von FARMWISSEN beitragen. Bugmeldungen und Feature-Vorschläge helfen, die Projekte stabiler und praxisnäher zu machen.
Dieser Teil richtet sich an Entwickler*innen, Studierende und alle, die aktiv an FARMWISSEN-Projekten mitarbeiten möchten.
| Erstelle einen eigenen Fork des Repositories. |  |
| Der Fork liegt anschließend unter deinem eigenen GitHub-Account. |  |
| Klone den Fork lokal und richte deine Entwicklungsumgebung ein. |  |
| Wähle ein Issue aus oder erstelle ein neues für deine geplante Änderung. |  |
| Kommentiere kurz, dass du an der Bearbeitung arbeitest. |  |
💡 Good First Contribution – Einstieg für Einsteiger*innen
- Verbesserungen an Dokumentation
- Korrekturen von Schreibfehlern
- Ergänzen von Beispielen
- Issues mit Labels wie good first issue oder help wanted
Tipp: Kurz im Issue melden, dass du es übernimmst.
| Erstelle einen neuen Branch, setze deine Änderungen um und teste sie lokal. |  |
| Committe deine Änderungen und pushe sie in dein Fork-Repository. |   |
| Öffne einen Pull Request im Original-Repository. |  |
| Beschreibe die Änderungen und verweise ggf. auf das Issue. |   |
Forks, Branches und Pull Requests ermöglichen eine strukturierte Zusammenarbeit. Klare Kommunikation erleichtert Reviews und beschleunigt die Integration.
Dieser Teil richtet sich an alle, die ein eigenes Projekt in der FARMWISSEN-Community veröffentlichen möchten.
Die FARMWISSEN GitHub Organisation bündelt Open-Source-Projekte mit Bezug zur Landwirtschaft, Agrarforschung und Praxis. Entscheidend ist ein klarer fachlicher oder technischer Mehrwert für die Community sowie eine offene Lizenz und gute Dokumentation.
README.mdLege im Repository ein .github-Verzeichnis an. Du kannst eine bestehende Struktur aus einem FARMWISSEN-Repository kopieren und anpassen.
Typische Inhalte:
ISSUE_TEMPLATE/bug_report.mdISSUE_TEMPLATE/feature_request.mdISSUE_TEMPLATE/question.mdISSUE_TEMPLATE/config.ymlPULL_REQUEST_TEMPLATE.mdStelle dein Projekt im FARMWISSEN Discord-Server im Kanal github-code-projekt vor oder nimm direkt Kontakt auf. Beschreibe Ziel, Nutzen und Entwicklungsstand.
Nach positiver Rückmeldung kann dein Repository in die FARMWISSEN GitHub Organisation übertragen werden. Du bleibst Maintainer*in und koordinierst Beiträge über Issues und Pull Requests.
Die Veröffentlichung eigener Projekte bündelt Wissen, erhöht Sichtbarkeit und stärkt nachhaltige Open-Source-Entwicklung.
| FARMWISSEN lebt von offener Zusammenarbeit. Dieses Tutorial zeigt dir die wichtigsten Wege, Teil der Community zu werden – vom Nutzen bestehender Projekte über Issues und Pull Requests bis hin zur Veröffentlichung eigener Repositories. |
Lucas Johannsen
FARMWISSEN / Farmwissen Netzwerk