Bidrag

evcc bygges af fællesskabet. De fleste måder at hjælpe på kræver ingen kode.

Start i det små

Start ikke med din store yndlingsfunktion, selvom AI-agenter gør det utroligt nemt og fristende. Læs først med i diskussionerne og issues, og få en fornemmelse af, hvordan fællesskabet arbejder. Din idé er sandsynligvis kommet op før, så søg efter den og deltag i den eksisterende samtale. Begynd med noget småt, og byg videre derfra. Større ændringer kræver enighed i et issue eller en diskussion, før du går videre til implementering og en pull request.

Hjælp andre

Mange spørgsmål i diskussionerne kan besvares af en, der har den samme enhed eller har haft det samme problem. Det hjælper også at sortere issues: genskab rapporterede fejl, bed om manglende logs, og henvis til dubletter. Indberet et problem forklarer, hvad et brugbart issue indeholder.

Test nye versioner

Nightly-buildet indeholder alt, hvad der er blevet merget siden den seneste udgivelse. Alle installationsvejledninger (f.eks. Linux, Docker eller Home Assistant) forklarer, hvordan du skifter til det. Tag en sikkerhedskopi af din installation, før du skifter. Nye funktioner starter ofte som eksperimentelle og skal aktiveres under Opsætning → Eksperimentel.

Til pull requests kan vedligeholderne udgive et testbuild med binærfiler og et Docker-image evcc/evcc:pr-<number>. En kort testrapport fra en med den passende hardware er ofte det, der får en ændring merget. Hvis en pull request endnu ikke har et testbuild, men du kunne teste den, er du velkommen til at bede om et i pull requesten.

Hvis du vil prøve nye versioner af iOS- og Android-appen tidligt, så se appens beta-afsnit.

Dine egne enheder

De bedste første bidrag kommer fra din egen opsætning. Du har en inverter, et hjemmebatteri, et køretøj eller en oplader, som vedligeholderne ikke kan teste. Bekræft rettelser, eller forbedr vejledningen i en skabelon. Er din enhed ikke understøttet endnu? Opsæt den først som en brugerdefineret enhed, og lav den om til en skabelon for alle, når den virker.

Oversæt

Brugergrænsefladen oversættes på Weblate. Tilføj et nyt sprog, eller tjek og forbedr et eksisterende, uden at du skal bruge udviklerværktøjer.

Forbedr dokumentationen

Hver side har et Rediger side-link nederst, der fører dig til kildeteksten på GitHub. Dokumentationen er skrevet på engelsk og tysk. Hvis du kun taler et af sprogene, så nævn det i din pull request, så hjælper vi med det andet.

Skriv kode

Retningslinjerne for bidrag dækker grundreglerne, udviklingsopsætningen og hvordan du tester lokalt. Generelle udviklingsemner diskuteres på Slack.

Byg noget omkring evcc

Dashboards, displays, værktøjer eller hardware-gadgets, der hjælper andre brugere, er også bidrag. REST API’et og MQTT API’et giver dig adgang til alle data fra din evcc-installation. Vis dit projekt frem i diskussionerne, og tilføj det til Flere seje projekter.

Projektoversigt

Repository	Hvad det er	Teknologi
evcc-io/evcc	Kerne, webgrænseflade og enhedsskabeloner	Go, Vue
evcc-io/app	iOS- og Android-app	React Native
evcc-io/optimizer	Optimizer-tjeneste	Python
evcc-io/docs	Denne dokumentation	Astro, Markdown
evcc-io/images	Linux-images til Raspberry Pi og andre boards	Armbian
evcc-io/hassio-addon	Home Assistant-app	Docker
evcc-io/evcc.io	Websted	Hugo

Indberet et problem viser, hvilket repository et problem hører til.

Tokens til bidragydere

Projektet lever af bidrag fra mange mennesker i form af kode, skabeloner, dokumentation, oversættelser, svar i diskussionerne eller detaljerede testrapporter.

Har du allerede bidraget en hel del? Send os en kort e-mail med dit GitHub-brugernavn, så udsteder vi et ubegrænset sponsortoken til dig.