Bijdragen

evcc wordt gebouwd door de community. Voor de meeste manieren om te helpen is geen code nodig.

Klein beginnen

Begin niet met uw grote lievelingsfunctie, ook al maken AI-agents dat ongelooflijk makkelijk en verleidelijk. Lees eerst mee in discussies en issues om te ontdekken hoe de community werkt. Uw idee is waarschijnlijk al eerder opgekomen, dus zoek ernaar en sluit aan bij het bestaande gesprek. Begin met iets kleins en bouw van daaruit verder. Voor grotere wijzigingen is eerst overeenstemming in een issue of discussie nodig, voordat u aan de implementatie en een pull request begint.

Anderen helpen

Veel vragen in de discussies kan iemand beantwoorden die hetzelfde apparaat heeft of hetzelfde probleem had. Triage helpt ook: gemelde bugs reproduceren, om ontbrekende logs vragen en naar duplicaten verwijzen. Een probleem melden legt uit wat een nuttig issue bevat.

Nieuwe versies testen

De nightly-versie bevat alles wat sinds de laatste release is samengevoegd. Alle installatiehandleidingen (bijv. Linux, Docker of Home Assistant) leggen uit hoe u ernaar overstapt. Maak een back-up van uw installatie voordat u overstapt. Nieuwe functies zijn in het begin vaak experimenteel en moeten worden ingeschakeld onder Configuratie → Experimenteel.

Voor een pull request kunnen maintainers een testversie publiceren met binaries en een Docker-image evcc/evcc:pr-<number>. Een kort testverslag van iemand met de passende hardware zorgt er vaak voor dat een wijziging wordt samengevoegd. Heeft een pull request nog geen testversie maar zou u die kunnen testen, vraag er dan gerust om in de pull request.

Wilt u nieuwe versies van de iOS- en Android-app vroeg uitproberen, kijk dan in de bètasectie van de app.

Uw eigen apparaten

De beste eerste bijdragen komen uit uw eigen installatie. U bezit een omvormer, thuisbatterij, voertuig of lader die de maintainers niet kunnen testen. Bevestig dat oplossingen werken of verbeter de instructies van een template. Wordt uw apparaat nog niet ondersteund? Stel het eerst in als gebruikergedefinieerd apparaat en maak er, zodra het werkt, een template voor iedereen van.

Vertalen

De interface wordt vertaald op Weblate. Voeg een nieuwe taal toe of controleer en verbeter een bestaande, zonder ontwikkeltools.

De documentatie verbeteren

Elke pagina heeft onderaan een link Pagina bewerken die u naar de bron op GitHub brengt. De documentatie wordt geschreven in het Engels en het Duits. Spreekt u maar één van beide, vermeld dat dan in uw pull request en wij helpen met de andere.

Code schrijven

De richtlijnen voor bijdragen behandelen de basisregels, de ontwikkelomgeving en hoe u lokaal test. Algemene ontwikkelonderwerpen worden besproken op Slack.

Iets bouwen rond evcc

Dashboards, displays, hulpprogramma’s of hardwaregadgets die andere gebruikers helpen, zijn ook bijdragen. De REST API en de MQTT API geven u toegang tot alle gegevens van uw evcc-installatie. Laat uw project zien in de discussies en voeg het toe aan Meer geweldige projecten.

Projectoverzicht

Repository	Wat het is	Technologie
evcc-io/evcc	Kern, webinterface en apparaattemplates	Go, Vue
evcc-io/app	iOS- en Android-app	React Native
evcc-io/optimizer	Optimizer-service	Python
evcc-io/docs	Deze documentatie	Astro, Markdown
evcc-io/images	Linux-images voor Raspberry Pi en andere boards	Armbian
evcc-io/hassio-addon	Home Assistant-app	Docker
evcc-io/evcc.io	Website	Hugo

Een probleem melden laat zien bij welke repository een probleem hoort.

Bijdragerstokens

Het project leeft van de bijdragen van veel mensen, in de vorm van code, templates, documentatie, vertalingen, antwoorden in de discussies of uitgebreide testverslagen.

Al flink bijgedragen? Stuur ons een korte e-mail met uw GitHub-gebruikersnaam en wij geven u een onbeperkt geldig sponsortoken.