Wie Sie zu ownCloud beitragen: Leitfaden für Entwickler

Wer kann beitragen

Wir freuen uns über Beiträge von allen – Entwickler, Dokumentationsautoren, Designer, Übersetzer, Tester und alle, die ownCloud verbessern möchten. Egal, ob Sie einen Tippfehler korrigieren oder eine komplette Web-Erweiterung entwickeln, dieser Leitfaden erklärt, wie Sie beitragen können.

Lizenzierung

Ziel-Lizenz für neue Projekte: Apache License 2.0

ownCloud stellt auf Apache 2.0 als Standardlizenz für neue Repositories und Komponenten unter dem OSPO um. Apache 2.0 ist eine freizügige Lizenz, gut verständlich, mit den meisten Anforderungen von Unternehmen und öffentlichem Sektor kompatibel und im Open-Source-Ökosystem weit verbreitet.

Bestehende Repositories können während einer Übergangsphase ihre bisherigen Lizenzen behalten:

Repository / Komponente	Aktuelle Lizenz	Übergangsplan
oCIS	Apache 2.0	Bereits auf Ziel-Lizenz
Desktop Client	GPL v2	In Prüfung
Android Client	GPL v2	In Prüfung
iOS Client	GPL v3	In Prüfung
ownCloud Server	AGPLv3	End-of-Life; keine Lizenzänderung geplant

Lizenzänderungen für bestehende Repositories werden mit Vorlauf und nach Rücksprache mit der Community kommuniziert. Wir ändern keine Lizenzen rückwirkend für bereits veröffentlichte Codes.

Kein CLA erforderlich – Wir nutzen DCO

ownCloud verlangt kein Contributor License Agreement (CLA). Früher nutzten wir ein CLA, das eine vollständige Übertragung der Urheberrechte an die ownCloud GmbH beinhaltete. Dieses CLA übertrug sämtliche Rechte, Titel und Ansprüche – einschließlich aller Urheberrechte – an Ihren Beiträgen auf ownCloud. Diese Praxis ist eingestellt. Für neue Beiträge zu Komponenten mit Apache 2.0-Lizenz ist dies nicht mehr erforderlich.

Stattdessen verwenden wir das Developer Certificate of Origin (DCO). Das DCO ist eine schlanke, commitbasierte Bestätigung, dass Sie berechtigt sind, den Code unter der Projektlizenz einzureichen. Es überträgt keine Urheberrechte an die ownCloud GmbH. Sie behalten das volle Eigentum an Ihren Beiträgen – im Sinne der Apache 2.0-Lizenz.

Um einen Commit zu signieren, fügen Sie eine Signed-off-by-Zeile hinzu:

git commit -s -m "Add photo metadata search support"

(Stellen Sie sicher, dass PGP aktiviert ist: https://docs.github.com/articles/about-gpg)

Dadurch wird eine Zeile wie diese hinzugefügt:

Signed-off-by: Ihr Name <your@email.com>

Der DCO-Text (verfügbar unter developercertificate.org) bestätigt:

Sie haben den Beitrag selbst verfasst oder sind berechtigt, ihn einzureichen.
Sie reichen ihn unter der Lizenz des Projekts ein.
Sie wissen, dass der Beitrag öffentlich ist und ein Protokoll darüber geführt wird.

Für Beitragende, die das alte CLA unterschrieben haben: Ihre bisherigen Beiträge bleiben gültig. Es ist keine weitere Aktion erforderlich. Neue Beiträge benötigen lediglich das DCO-Sign-off.

Für Unternehmensbeitragende: Falls Ihr Arbeitgeber Richtlinien zum geistigen Eigentum hat, stellen Sie sicher, dass Sie unter dem DCO beitragen dürfen. Viele Unternehmen haben generelle Open-Source-Beitragsrichtlinien. Falls nicht, erleichtert der commitbasierte DCO die gezielte Freigabe im Vergleich zu einem umfassenden CLA.

So tragen Sie bei

Suchen Sie sich eine Aufgabe. Durchstöbern Sie Issues mit dem Label „good-first-issue“ in unseren Repositories. Prüfen Sie die Projekt-Roadmap und offene RFCs für größere Initiativen. Wenn Sie eine Idee haben, eröffnen Sie zuerst ein Issue, um sie zu besprechen, bevor Sie viel Zeit investieren.
Forken und Branch anlegen. Forken Sie das relevante Repository und erstellen Sie einen Feature-Branch. Branch-Namen sollten aussagekräftig sein: feat/photo-metadata-search, fix/ocm-federation-timeout, docs/improve-deployment-guide.
Entwickeln. Befolgen Sie die Coding-Konventionen des Repositories (sprachspezifische Linting-Regeln werden im CI geprüft). Schreiben Sie Tests für neue Funktionen. Dokumentieren Sie neue Features, Konfigurationsoptionen und APIs. Wenn Sie KI-gestützte Entwicklung nutzen, beachten Sie unsere AI-Assisted Contribution Policy – offenlegen, verstehen, testen, dokumentieren.
Commit mit DCO-Sign-off. Jeder Commit muss eine Signed-off-by-Zeile enthalten. Commits ohne DCO-Sign-off werden von unseren CI-Prüfungen markiert und können nicht gemerged werden.
Pull Request einreichen. Schreiben Sie eine klare PR-Beschreibung: Was ändert sich, warum und wie soll getestet werden? Verweisen Sie auf relevante Issues. Fügen Sie für UI-Änderungen Screenshots bei. Reagieren Sie auf Feedback im Review.
Review und Merge. Maintainer prüfen Ihren PR auf Korrektheit, Codequalität, Testabdeckung, Dokumentation und Architektur. Das kann mehrere Runden dauern – das ist normal. PRs, die den Review bestehen, werden von einem Maintainer gemerged.

Beitragsarten

Code ist die sichtbarste Form des Beitrags, aber bei weitem nicht die einzige. Wir schätzen und würdigen:

Dokumentation: Leitfäden, API-Dokumentation, Deployment-Anleitungen, Übersetzungen.
Testing: Fehlerberichte mit Reproduktionsschritten, Testfallbeiträge, exploratives Testen.
Design: UX-Feedback, Wireframes, Verbesserungen bei der Barrierefreiheit.
Community: Fragen im Forum beantworten, neue Beitragende betreuen, Events organisieren.
Advocacy: Blogbeiträge, Konferenzvorträge, Fallstudien.

Verhaltenskodex

Alle Beitragenden müssen unseren Verhaltenskodex einhalten. Wir setzen uns für ein einladendes, respektvolles und inklusives Umfeld ein.

Verstöße und Bedenken können an coc@owncloud.com gemeldet werden.

Kommunikationskanäle

GitHub Issues und PRs: Hauptkanal für technische Diskussionen.
Dokumentation: doc.owncloud.com
Community-Foren: central.owncloud.org
OSPO-Kontakt: ospo@kiteworks.com

Anerkennung

GitHub-Beitragsstatistiken und Release Notes.
Security Hall of Fame für Meldungen von Schwachstellen.
Community-Spotlights und Event-Einladungen.
Contributor-Programme: Aktive Beitragende können zu Reviewern, Maintainern oder Mitgliedern des Advisory Boards eingeladen werden.

Häufig gestellte Fragen

Jeder kann zu ownCloud beitragen – dazu zählen Entwickler, Dokumentationsautoren, Designer, Übersetzer, Tester und alle, die die Plattform verbessern möchten. Beiträge reichen von der Korrektur von Tippfehlern bis hin zur Entwicklung kompletter Web-Erweiterungen.

ownCloud stellt auf die Apache License 2.0 als Standardlizenz für neue Projekte und Komponenten um. Diese Lizenz ist freizügig, weit verbreitet und mit den meisten Anforderungen von Unternehmen und dem öffentlichen Sektor kompatibel.

Nein, ownCloud verlangt kein CLA mehr. Stattdessen kommt das Developer Certificate of Origin (DCO) zum Einsatz – eine schlanke Bestätigung pro Commit, dass Sie berechtigt sind, Code unter der Projektlizenz einzureichen, ohne das Urheberrecht zu übertragen.

Neben Programmierung umfasst die Mitarbeit an ownCloud auch Dokumentation (Anleitungen, API-Dokumente, Übersetzungen), Tests (Fehlermeldungen, Testfälle), Design (UX-Feedback, Barrierefreiheit), Community-Support (Mentoring, Beantwortung von Fragen) und Öffentlichkeitsarbeit (Blogbeiträge, Vorträge).