AI-ondersteunde ontwikkeling: ownCloud-bijdragengids

Onze positie

ownCloud verwelkomt bijdragen die zijn gemaakt met behulp van AI-tools.

Wij vinden dat goede ideeën niet mogen worden tegengehouden door iemands programmeerervaring. Als je een visie hebt om ownCloud te verbeteren — een nieuwe webextensie, een beter workflow, een oplossing die je duidelijk kunt omschrijven — en AI helpt je om die visie om te zetten in werkende code, dan willen we jouw bijdrage graag ontvangen.

We hebben een gedetailleerde gids gepubliceerd over AI-ondersteunde ontwikkeling voor oCIS-webextensies op owncloud.dev. Die gids behandelt het volledige proces: van architectuurbesprekingen met een AI-assistent, via onderzoek, opzet, implementatie tot verfijning en bijdrage. We moedigen je aan deze te volgen.

Wat Wij Verwachten

AI-ondersteunde bijdragen worden aan dezelfde kwaliteitsnormen gehouden als elke andere bijdrage. Het beoordelingsproces kijkt niet naar hoe de code is geschreven. Het gaat erom dat de code werkt, getest is, gedocumenteerd is en onderhoudbaar blijft.

Elke AI-ondersteunde pull request moet aan deze vereisten voldoen:

Transparantie. Vermeld in je PR-beschrijving dat AI-tools zijn gebruikt bij de ontwikkeling. Noem de tool (bijv. Claude Code, GitHub Copilot, Cursor). Dit is geen stigma — het is transparantie. We houden dit bij om ons contributor-ecosysteem te begrijpen en onze reviewprocessen te verbeteren.
Begrip. Je moet begrijpen wat de code doet. Als een reviewer vraagt: “waarom handelt deze functie de fout op deze manier af?” en jouw antwoord is “de AI heeft het zo geschreven”, dan is dat niet voldoende. Jij bent de auteur. De AI is een hulpmiddel. Als je de code niet kunt uitleggen, is deze niet klaar voor indiening.
Testen. AI-gegenereerde code moet getest worden. Unit tests voor logica. Handmatig verkennend testen voor UI. De AI-devgids legt uit hoe je browser DevTools, HAR-bestanden en console-uitvoer gebruikt om effectief te debuggen. PR’s zonder voldoende testdekking worden teruggestuurd.
Documentatie. Documenteer wat de code doet, hoe deze gebruikt moet worden en welke configuratie nodig is. Als de code nieuwe API’s, omgevingsvariabelen of extensiepunten introduceert, moeten deze worden gedocumenteerd.
Codekwaliteit. AI-gegenereerde code heeft de neiging om overbodige logica, ongebruikte variabelen, dubbele stijlen en te complexe condities te bevatten. Voer voor het indienen een opschoningsronde uit. Vraag je AI-tool om te refactoren, dode code te verwijderen en te vereenvoudigen. Onze CI-pijplijn bevat linting — PR’s die niet slagen voor lintcontroles worden teruggestuurd.
Licentie-naleving. Zorg ervoor dat je AI-tool geen code heeft geïntroduceerd die is gekopieerd uit incompatibele licenties. Jij bent verantwoordelijk voor de herkomst van elke regel in je PR.

Wat We Niet Doen

We wijzen geen bijdragen af omdat ze AI-ondersteund zijn. We eisen niet dat bijdragers “senior developers” zijn. We houden geen drempel op basis van hoe je de code hebt geschreven.

We accepteren echter ook geen bijdragen waarbij de bijdrager niet kan deelnemen aan het reviewproces. Als een maintainer om aanpassingen vraagt en je kunt deze niet maken — omdat je de code niet begrijpt of omdat je al verder bent gegaan — kan de PR worden gesloten. Dat is dezelfde standaard die we op alle bijdragen toepassen.

Richtlijnen voor Maintainers en Reviewers

AI-ondersteunde bijdragen kunnen meer review-inspanning vragen. De code kan syntactisch correct zijn, maar structureel suboptimaal. Patronen kunnen onbekend zijn of afwijken van de projectconventies.

Reviewers dienen:

Dezelfde beoordelingsnormen toepassen als bij elke bijdrage. Geen lagere lat. Geen hogere lat.
Specifiek zijn in feedback. “Dit volgt onze patronen niet” is minder bruikbaar dan “We gebruiken compositie boven overerving in deze module — zie ExampleComponent.vue voor het patroon.”
Geduldig zijn met lerende bijdragers. Een bijdrager van wie de eerste PR drie reviewrondes nodig heeft, kan een langdurige maintainer worden. Dat is precies de bedoeling.
Markeren als AI-gegenereerde code materiaal lijkt te bevatten dat is gekopieerd uit andere projecten of frameworks met incompatibele licenties.

Richtlijnen voor Maintainers en Reviewers

AI in Onze Eigen Ontwikkeling

De interne engineeringteams van ownCloud gebruiken ook AI-tools. Wij hanteren voor onszelf dezelfde standaarden: transparantie in commitberichten waar nodig, volledig begrip van gegenereerde code en menselijke verantwoordelijkheid voor elke merge.

Wij geloven dat AI-ondersteunde ontwikkeling, mits verantwoord toegepast, de drempel tot bijdragen verlaagt zonder de kwaliteit te verminderen. Dat is het doel.

Veelgestelde vragen

Ja, ownCloud verwelkomt bijdragen die met behulp van AI-tools zijn gemaakt. Zij vinden dat goede ideeën niet mogen worden tegengehouden door programmeerervaring en moedigen bijdragers aan om AI te gebruiken om hun visie om te zetten in werkende code. Wel gelden er richtlijnen en vereisten.

AI-ondersteunde pull requests moeten aan diverse vereisten voldoen: vermelding van het gebruik van AI-tools in de PR-beschrijving, volledige begrip van de code door de bijdrager, voldoende testen (unit en handmatig), goede documentatie, hoge codekwaliteit en naleving van licenties om gekopieerde code uit incompatibele bronnen te voorkomen.

Nee, ownCloud wijst bijdragen niet af enkel omdat ze met AI zijn gemaakt. Ze hanteren dezelfde standaarden voor alle bijdragen en maken geen onderscheid op basis van de manier waarop de code is geschreven.

ownCloud hanteert voor AI-ondersteunde bijdragen dezelfde kwaliteitsstandaarden als voor andere bijdragen. Reviewers passen consequente standaarden toe, geven gerichte feedback, hebben geduld met lerende bijdragers en signaleren mogelijke licentieproblemen bij gekopieerd materiaal.