Hoe je kunt bijdragen aan ownCloud: Gids voor ontwikkelaars

Wie kan bijdragen

We verwelkomen bijdragen van iedereen – ontwikkelaars, documentatieschrijvers, ontwerpers, vertalers, testers en iedereen die wil helpen ownCloud te verbeteren. Of je nu een typefout corrigeert of een complete webextensie bouwt, deze gids legt uit hoe je kunt bijdragen.

Licenties

Doellicentie voor nieuwe projecten: Apache License 2.0

ownCloud stapt over op Apache 2.0 als standaardlicentie voor nieuwe repositories en componenten onder de OSPO. Apache 2.0 is permissief, goed begrepen, compatibel met de meeste vereisten voor inkoop in de publieke en private sector en breed geaccepteerd binnen het open source-ecosysteem.

Bestaande repositories kunnen hun huidige licenties behouden gedurende een overgangsperiode:

Repository / Component	Huidige licentie	Transitieplan
oCIS	Apache 2.0	Al op doellicentie
Desktop Client	GPL v2	Wordt geëvalueerd
Android Client	GPL v2	Wordt geëvalueerd
iOS Client	GPL v3	Wordt geëvalueerd
ownCloud Server	AGPLv3	End-of-life; geen licentiewijziging gepland

Licentiewijzigingen voor bestaande repositories worden vooraf aangekondigd en met de community besproken. We wijzigen geen licenties met terugwerkende kracht op reeds uitgebrachte code.

Geen CLA vereist – We gebruiken DCO

ownCloud vereist geen Contributor License Agreement (CLA). We gebruikten eerder een CLA die een volledige overdracht van het auteursrecht aan ownCloud GmbH inhield. Die CLA droeg al je rechten, titels en belangen – inclusief alle rechten onder het auteursrecht – in je bijdragen over aan ownCloud. Deze praktijk is beëindigd. Het is niet langer vereist voor nieuwe bijdragen aan componenten met een Apache 2.0-licentie.

In plaats daarvan gebruiken we het Developer Certificate of Origin (DCO). De DCO is een eenvoudige, per-commit verklaring dat je het recht hebt om de code onder de licentie van het project in te dienen. Het auteursrecht wordt niet overgedragen aan ownCloud GmbH. Je behoudt het volledige eigendom van je bijdragen – binnen de voorwaarden van de Apache 2.0-licentie.

Om een commit te ondertekenen, voeg je een Signed-off-by-regel toe:

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

(Zorg dat PGP is ingeschakeld: https://docs.github.com/articles/about-gpg)

Dit voegt een regel toe zoals:

Signed-off-by: Jouw Naam <jouw@email.com>

De DCO-tekst (beschikbaar op developercertificate.org) bevestigt dat:

Je de bijdrage hebt geschreven, of het recht hebt om deze in te dienen.
Je deze indient onder de licentie van het project.
Je begrijpt dat de bijdrage openbaar is en dat er een registratie wordt bijgehouden.

Voor bijdragers die eerder de oude CLA hebben ondertekend: Je bestaande bijdragen blijven geldig. Geen verdere actie vereist. Nieuwe bijdragen hoeven alleen een DCO-sign-off te bevatten.

Voor zakelijke bijdragers: Als je werkgever beleid heeft rond intellectueel eigendom, zorg dan dat je toestemming hebt om bij te dragen onder de DCO. Veel organisaties hebben een algemeen open source-bijdragebeleid. Als dat niet zo is, maakt het per-commit karakter van de DCO het eenvoudiger om gerichte goedkeuring te krijgen dan bij een algemene CLA.

Hoe kun je bijdragen

Zoek iets om aan te werken. Bekijk issues met het label “good-first-issue” in onze repositories. Controleer de project-roadmap en open RFC’s voor grotere initiatieven. Heb je een idee? Open eerst een issue om het te bespreken voordat je veel tijd investeert.
Fork en branch. Fork de relevante repository en maak een feature branch aan. Branch-namen moeten beschrijvend zijn: feat/photo-metadata-search, fix/ocm-federation-timeout, docs/improve-deployment-guide.
Ontwikkel. Volg de codeerconventies van de repository (taalspecifieke lintingregels worden afgedwongen in CI). Schrijf tests voor nieuwe functionaliteit. Documenteer nieuwe features, configuratie-opties en API’s. Gebruik je AI-ondersteunde ontwikkeling, volg dan ons AI-Assisted Contribution Policy – maak het gebruik bekend, begrijp het, test en documenteer.
Commit met DCO-sign-off. Elke commit moet een Signed-off-by-regel bevatten. Commits zonder DCO-sign-off worden door onze CI-controles gemarkeerd en kunnen niet worden samengevoegd.
Dien een pull request in. Schrijf een duidelijke PR-beschrijving: wat verandert er, waarom en hoe moet het getest worden. Verwijs naar gerelateerde issues. Voeg schermafbeeldingen toe bij UI-wijzigingen. Reageer op feedback uit de review.
Review en merge. Beheerders beoordelen je PR op juistheid, codekwaliteit, testdekking, documentatie en architecturale aansluiting. Dit kan meerdere rondes duren. Dat is normaal. PR’s die de review doorstaan, worden door een beheerder samengevoegd.

Soorten bijdragen

Code is de meest zichtbare vorm van bijdragen, maar zeker niet de enige. We waarderen en erkennen:

Documentatie: Handleidingen, API-documentatie, inzetinstructies, vertalingen.
Testen: Bugmeldingen met stappen om te reproduceren, bijdragen aan testcases, verkennend testen.
Ontwerp: UX-feedback, wireframes, verbeteringen in toegankelijkheid.
Community: Vragen beantwoorden op fora, nieuwe bijdragers begeleiden, evenementen organiseren.
Promotie: Blog posts, presentaties op conferenties, praktijkvoorbeelden.

Gedragscode

Van alle bijdragers wordt verwacht dat ze onze gedragscode volgen. We zetten ons in voor een gastvrije, respectvolle en inclusieve omgeving.

Overtredingen en zorgen kunnen worden gemeld via coc@owncloud.com.

Communicatiekanalen

GitHub Issues en PR’s: Primair kanaal voor technische discussies.
Documentatie: doc.owncloud.com
Community Forums: central.owncloud.org
OSPO Contact: ospo@kiteworks.com

Erkenning

GitHub-bijdragersgrafieken en releasenotes.
Security hall of fame voor melders van kwetsbaarheden.
Community spotlights en uitnodigingen voor evenementen.
Contributor-trajecten: actieve bijdragers kunnen worden uitgenodigd als reviewers, beheerders of leden van de adviesraad.

Veelgestelde vragen

Iedereen kan bijdragen aan ownCloud, waaronder ontwikkelaars, documentatieschrijvers, ontwerpers, vertalers, testers en iedereen die geïnteresseerd is in het verbeteren van het platform. Bijdragen kunnen variëren van het corrigeren van typefouten tot het bouwen van complete webextensies.

ownCloud stapt over op de Apache License 2.0 als standaardlicentie voor nieuwe projecten en componenten. Deze licentie is permissief, breed geaccepteerd en compatibel met de meeste vereisten voor inkoop in de zakelijke en publieke sector.

Nee, ownCloud vereist geen CLA meer. In plaats daarvan wordt het Developer Certificate of Origin (DCO) gebruikt, een eenvoudige verklaring per commit die bevestigt dat je het recht hebt om code in te dienen onder de licentie van het project zonder het auteursrecht over te dragen.

Naast coderen kun je aan ownCloud bijdragen via documentatie (handleidingen, API-documentatie, vertalingen), testen (bugmeldingen, testcases), ontwerp (UX-feedback, verbeteringen in toegankelijkheid), community support (mentorschap, vragen beantwoorden) en promotie (blog posts, presentaties).