Improve sponsoring page

docs/sponsorship.mdx

@@ -6,22 +6,130 @@ import SponsorToken from "/docs/_sponsortoken.mdx";
 
 # Sponsorship
 
-Wir von evcc glauben an Open Source Software. Unser Ziel ist, eine Best-in-Class Lösung für das Laden von Elektroautos zu entwickeln, die mit bestehender Hardware und Haustechnik zusammenspielt. evcc unterstützt schon heute eine lange Liste an Fahrzeugen, Wallboxen, Energiezählern, Wechselrichtern und Batteriesystemen. Momentan kommen regelmäßig neue Hersteller dazu. Die Entwicklung und Pflege der Software ist zeitaufwändig. Daher sind wir auf eure Unterstützung als Community angewiesen, um das Projekt am Laufen zu halten.
+Wir von evcc glauben an Open-Source-Software.
+Unser Ziel ist es, das Laden von Elektroautos lokal, ohne Cloud, ohne Datensammlung oder Herstellerbindung, zu ermöglichen.
+Die Liste der unterstützten Geräte wächst stetig.
+Wir legen Wert darauf, dass evcc einfach zu bedienen bleibt und dennoch viele Schnittstellen für fortgeschrittene Nutzer bietet.
 
-evcc ist zwar Open Source, aber wir möchten auch die Hersteller ermutigen, Open-Source-Hardware-Geräte und öffentliche Dokumentation zur Verfügung zu stellen und Open-Source-Projekte wie das unsere zu unterstützen, die einen zusätzlichen Wert für sonst geschlossene Hardware bieten. Wo dies nicht der Fall ist, benötigt evcc _Contributor's & Sponsor-Token_ zur Finanzierung der laufenden Entwicklung und Unterstützung von evcc.
+Um die Weiterentwicklung zu sichern, brauchen wir eure Unterstützung – finanziell oder durch aktive Mitarbeit.
 
-Das persönliche _Contributor's & Sponsor-Token_ erfordert ein [Github-Sponsoring](https://github.com/sponsors/evcc-io). Wir haben diesen Weg gewählt, weil es einfach zu integrieren ist und keine Kommission beinhaltet. Unter [sponsor.evcc.io](https://sponsor.evcc.io) kann das _Contributor's & Sponsor-Token_ beantragt werden. Ein Sponsor-Token ist so lange gültig wie die Patenschaft aktiv ist und kann jederzeit neu ausgestellt werden. Es kann für beliebig viele Geräte verwendet werden. Trage das Token in deine `evcc.yaml` ein, um die damit verbundenen Geräteimplementierungen und das Supporter-Konfetti freizuschalten. Danke für die Unterstützung! 💚 🎉
+## Community Finanzierung 🤘💚
 
-:::info
+Der Code von evcc ist offen auf GitHub verfügbar.
+Für die Verwendung vieler kommerzieller Wallboxen haben wir uns entschieden ein Sponsortoken zu erfordern.
+Ausgenommen von dieser Regel sind Open-Hardware Wallboxen, Produkte mit gutem Community-Karma und Hersteller, die die Entwicklung von evcc aktiv unterstützen.
+Schaltsteckdosen und Plugins sind auch tokenfrei nutzbar.
 
-Dadurch, dass Github die Bezahlmöglichkeiten für das Sponsoring geändert hat, ist leider kein Paypal mehr möglich.
+Uns ist wichtig, dass die Finanzierung des Projekts von der Community getragen wird.
+Damit ist natürlicherweise sichergestellt, dass sich das Projekt nach den Vorstellungen seiner Nutzer entwickelt und nicht große Firmen oder Investoren die Richtung vorgeben.
 
-Wer keine Kredit-/Debitkarte verwenden möchte, kann sich diesbezüglich per Mail an [email protected] wenden.
+## Sponsortoken
 
-:::
+Wir haben uns dafür entschieden, Github Sponsoring zu verwenden, da es für uns einfach zu integrieren ist und GitHub keine Gebühren erhebt.
+Euer Beitrag landet also komplett beim Projekt.
 
-Alle Wallboxen, die in der Dokumentation mit 💚 gekennzeichnet sind, erfordern ein Sponsor-Token.
-Open-Hardware Wallboxen und Produkte mit gutem Community-Karma sind tokenfrei nutzbar.
-Gleiches gilt für Hersteller, welche die evcc Entwicklung aktiv unterstützen.
+Wir bieten zwei Modelle an:
+
+- **[Monatlich ab 2$](https://github.com/sponsors/evcc-io?frequency=recurring)**: Unterstütze das Projekt mit einem kleinen monatlichen Betrag.
+Das gibt uns Planungssicherheit und euch die Freiheit, das Sponsoring monatlich ändern oder stoppen zu können.
+Dein Sponsortoken ist so lange gültig, wie Github Sponsoring aktiv ist.
+- **[Einmalig ab 100$](https://github.com/sponsors/evcc-io?frequency=one-time)**: Für einen einmaligen Beitrag, erhälst du ein Sponsortoken mit unbegrenzter Gültigkeit.
+Ab einem Beitrag von 200$ bekommst du zusätzlich zu deinem persönlichen Token auch noch zwei weitere, die du an Freunde oder Familie weitergeben kannst.
+
+Dein Sponsortoken kannst du über [sponsor.evcc.io](https://sponsor.evcc.io) einsehen.
+
+Als kleines Dankeschön wird in der evcc UI **digitales Supporter-Konfetti 🎉** freigeschaltet und du kannst dir einmal ein cooles Set an **evcc Stickern ☀️** per Post zuschicken lassen.
+
+## Contributor's Token
+
+Du hast Lust, an der Entwicklung mitzuwirken?
+Wir freuen uns über jeden Beitrag.
+Schau dir gerne die Liste an [offenen GitHub Issues](https://github.com/evcc-io/evcc/issues) an oder [melde dich bei uns](mailto:[email protected]) mit konkreten Ideen, an denen du gerne mitarbeiten möchtest.
+Auch signifikante Beiträge zur [Dokumentation](https://github.com/evcc-io/docs) oder [Übersetzung](https://github.com/evcc-io/evcc/blob/master/CONTRIBUTING.md#adding-or-modifying-translations) qualifizieren für ein Contributor's Token.
+[Hier](https://github.com/evcc-io/evcc/blob/master/CONTRIBUTING.md) findest du weitere Informationen, wie du loslegen kannst.
+
+Als Contributor zum Projekt stellen wir dir gerne ein unbefristetes Unterstützertoken aus.
+Schreib uns dafür [eine kurze Mail](mailto:[email protected]) mit deinem GitHub-Namen.
+
+## Test-Token
+
+Du setzt evcc zum ersten Mal auf und würdest gerne prüfen, ob alle deine Geräte funktionieren?
+Dafür kannst du das Test-Token hier verwenden.
+Es hat eine begrenzte Gültigkeit, wird aber regelmäßig erneuert.
 
 <SponsorToken />
+
+Wenn alles läuft, kannst du es später gegen ein richtiges Sponsortoken austauschen.
+
+## Häufige Fragen
+
+#### Ich bin jetzt GitHub-Sponsor, wie bekomme ich mein Token?
+
+Unter [sponsor.evcc.io](https://sponsor.evcc.io) kannst du dein(e) Token einsehen.
+
+Es kann leider vorkommen, dass die Sponsor-Information von GitHub für uns erst nach einigen Minuten (in seltenen Fällen am nächsten Tag) verfügbar ist.
+Hab also etwas Geduld und schau später noch mal rein.
+In der Zwischenzeit kannst du auch mit dem Test-Token arbeiten.
+Sollte dein Token auch später nicht auftauchen, [melde dich bei uns](mailto:[email protected]).
+
+Stelle sicher, dass du eine der vordefinierten Stufen bei GitHub ausgewählt hast.
+Bei freien Beträgen (bspw. einmalig $2) wird kein Token erstellt.
+
+#### Ich habe ein Gewerbe und möchte evcc kommerziell einsetzen. Kann ich das machen?
+
+Ja, das ist kein Problem.
+Deine Kunden müssen dafür jeweils ein Sponsortoken erstellen.
+Alternativ können wir dir auch mehrere Sponsortoken auf einmal ausstellen und dir eine Rechnung mit entsprechender Umsatzsteuer schreiben.
+[Melde dich dafür bei uns](mailto:[email protected]).
+
+*Hinweis: Für weitere Funktionen wie bspw. [Lastmanagement](/docs/features/loadmanagement) werden wir explizite kommerzielle Unterstützungsmodelle anbieten.
+Dazu aber später mehr.*
+
+#### Wo trage ich mein Token ein?
+
+Aktuell muss das Token händisch in die `evcc.yaml` eingetragen werden:
+
+```yaml title="evcc.yaml"
+sponsortoken: ey...zuE
+```
+
+Wir arbeiten daran, dass dies in Zukunft auch über die UI möglich ist.
+
+#### Kann ich mein Token in mehreren Installationen nutzen?
+
+Ja, solange es deine persönlichen evcc-Instanzen sind, ist eine mehrfache Nutzung kein Problem.
+Wir vertrauen hier auf deine Ehrlichkeit.
+
+#### Ich habe mein Token verloren. Wie bekomme ich ein neues?
+
+Du kannst dein Token jederzeit über [sponsor.evcc.io](https://sponsor.evcc.io) einsehen.
+
+#### Kann ich mein Token weiterverkaufen oder einen "gebrauchten" Token kaufen?
+
+Die Token sind personalisiert und enthalten deinen GitHub-Namen.
+Bitte gib sie nicht an Dritte weiter.
+Kaufe auch keine "gebrauchten" Token auf Online-Plattformen.
+Wenn du das Projekt voranbringen willst, unterstütze uns lieber direkt.
+
+#### Ich benötige eine längere Test-Zeit.
+
+Sollte das Test-Token ablaufen und du bist dir noch nicht sicher, ob evcc für dich wie erwartet funktioniert, kannst du nach Ablauf ein neues Test-Token eintragen.
+Wir aktualisieren das Token hier regelmäßig.
+
+#### Mein Token funktioniert nicht. Woran liegt das?
+
+Sollte dein Token nicht funktionieren, kann das verschiedene Gründe haben:
+
+- **Monatliches Sponsoring ausgelaufen:** Prüfe deinen Sponsor-Status bei GitHub und auf [sponsor.evcc.io](https://sponsor.evcc.io).
+- **Formatierungsfehler:** Prüfe, ob das Token korrekt in der `evcc.yaml` eingetragen ist.
+- **Exerimentelle Config UI:** Hast du die experimentelle Sponsortoken-Funktion 🧪 in der Konfigurationsoberfläche verwendet?
+Wenn ja, wird das Token in der `evcc.yaml` nicht mehr berücksichtigt und stattdessen deine UI-Eingabe (gespeichert in der `evcc.db`) verwendet.
+Mit [`evcc migrate --reset`](/docs/reference/cli/evcc_migrate) oder dem Löschen der `evcc.db` kommst du wieder zum alten Verhalten.
+
+Sollten die obigen Schritte nicht helfen, [melde dich bei uns](mailto:[email protected]) und wir prüfen das gerne.
+
+#### Ich bin einmaliger Sponsor, mein Sponsor-Badge auf GitHub wird aber nicht mehr angezeigt.
+
+Die Anzeige des Sponsor-Badges an deinem GitHub-Profil können wir leider nicht beeinflussen.
+Aktuell zeigt GitHub das Badge bei einmaligen Sponsorings nur im ersten Monat an.
+Auf deinen Sponsor-Status bei evcc hat das aber keinen Einfluss.

i18n/en/docusaurus-plugin-content-docs/current/sponsorship.mdx

@@ -6,30 +6,126 @@ import SponsorToken from "/docs/_sponsortoken.mdx";
 
 # Sponsorship
 
-We at evcc believe in open source software. Our goal is to develop a best-in-class solution for charging Electric Vehicles that interacts with existing hardware and technology.
+We at evcc believe in open source software.
+Our goal is to enable local, cloud-free, privacy-friendly and manufacturer-independent charging of electric vehicles.
+The list of supported devices is growing steadily.
+We value an enjoyable user experience while also offering a high degree of flexibility for advanced users.
 
-evcc already supports a long list of Vehicles, Chargers, Meters, Inverters, and Battery systems, with more being added regularly. However, the development and maintenance of evcc is very time consuming - so we are dependent on your support as a community to keep the project going.
+To ensure the ongoing development, we need your support - financially or through active contribution.
 
-evcc is open source, but we also want to encourage manufacturers to provide open source hardware devices, public documentation, and to support open source projects like ourselves that offer additional value for otherwise closed hardware. Where this is not the case, evcc's _Contributor Sponsor Tokens_ need to finance ongoing development and support.
+## Community Funding 🤘💚
 
-The personal _Contributor Sponsor Token_ requires [GitHub sponsoring](https://github.com/sponsors/evcc-io). We've chosen to use GitHub sponsors as it's easy to integrate, and does not include commission to be paid by any party. At [sponsor.evcc.io](https://sponsor.evcc.io), the _Contributor Sponsor Token_ can be requested, which is valid for as long as the sponsorship is active, on as many installations as desired - and can be renewed at any time. Simply enter the token in your `evcc.yaml` to unlock the associated functionality, and super-special, super-awesome supporter confetti inside evcc.
+The code of evcc is open source and available on GitHub.
+However, for many commercial EV chargers, we require a sponsor token.
+Open-hardware chargers, products with a good community karma and manufacturers who actively support evcc development are supported without a token.
+The same applies to simple switch-sockets and plugins.
 
-Thank you for your support! 💚🎉
+We want the project to be funded by the community.
+This ensures that the project develops according to the needs of its users and is not influenced by large companies or investors.
 
-:::info
+## Sponsor Tokens
 
-GitHub unfortunately no longer accepts PayPal for sponsorship.
+We have chosen to use GitHub Sponsoring, as it is easy to integrate and does not include any commission to be paid by any party.
+Your contribution will therefore land directly with the project - without payment or processing fees.
 
-If you don't want to use a credit / debit card, please contact us at [email protected]
+We offer two models:
 
-:::
+- **[Monthly ≥ 2$](https://github.com/sponsors/evcc-io?frequency=recurring)**: Support the project with a small monthly contribution.
+This gives us planning security and you have the freedom to change the sponsorship monthly or stop it at any time.
+- **[One-time ≥ 100$](https://github.com/sponsors/evcc-io?frequency=one-time)**: For a one-time contribution, you'll receive a sponsor token with unlimited validity.
+For contributions of 200$ or more, you'll receive two additional tokens that you can give to friends or family.
 
-All chargers marked with 💚 in the documentation require a Sponsor Token.
-Open-hardware chargers and products with good community karma can be used without a token.
-The same applies to manufacturers who actively support evcc development.
+Your sponsor token can be viewed at [sponsor.evcc.io](https://sponsor.evcc.io).
 
-## How to Use your Token
+As a small thank you, you'll receive **digital supporter confetti 🎉** inside evcc and can order a cool set of **evcc stickers ☀️** which we'll ship to you.
 
-Simply add the following line to your `evcc.yaml`:
+## Contributor Tokens
+
+You want to contribute to the development?
+We'd love that!
+Look at the [list of open issues](https://github.com/evcc-io/evcc/issues) or [contact us](mailto:[email protected]) with concrete ideas on how you'd like to contribute.
+Significant contributions to the [documentation](https://github.com/evcc-io/docs) or [translations](https://github.com/evcc-io/evcc/blob/master/CONTRIBUTING.md#adding-or-modifying-translations) also qualify for a contributor token.
+[Here](https://github.com/evcc-io/evcc/blob/master/CONTRIBUTING.md) you'll find more information on how to get started.
+
+As a contributor, we'll issue you an unlimited contributor token.
+[Send us a short email](mailto:[email protected]) with your GitHub username.
+
+## Test Tokens
+
+You want to test evcc and check if all your devices are supported?
+For that, you can use our test token.
+It has a limited validity, but will be regularly renewed.
 
 <SponsorToken />
+
+If everything works, you can later exchange it for a real sponsor token.
+
+## Frequently Asked Questions
+
+#### I am now a GitHub Sponsor, how do I get my token?
+
+At [sponsor.evcc.io](https://sponsor.evcc.io) you can view your token(s).
+
+It may take a while (sometimes hours) until we receive the sponsor information from GitHub.
+So please be patient and check back later.
+In the meantime, you can also work with the test token.
+If your token does not appear after a while, [contact us](mailto:[email protected]).
+
+Also make sure that you have selected one of the predefined levels when sponsoring.
+If you've entered a lower custom amount (e.g. $2 one-time), no token will be created.
+
+#### I have a business and want to use evcc commercially. Can I do that?
+
+Yes, that's no problem.
+Your customers will then each need to create a sponsor token.
+Alternatively, we can also issue you several sponsor tokens at once and send you an invoice with the corresponding VAT.
+[Write us an email](mailto:[email protected]) with your requirements and we'll get back to you.
+
+#### Where do I enter my token?
+
+Currently, the token must be entered manually in the `evcc.yaml`:
+
+```yaml title="evcc.yaml"
+sponsortoken: ey...zuE
+```
+
+We're working on making this configurable via the UI.
+
+#### Can I use my token on multiple installations?
+
+Yes, as long as it's your personal evcc instances, multiple usage is no problem.
+We trust you to be honest about that.
+
+#### I lost my token. How do I get a new one?
+
+You can view your token(s) at [sponsor.evcc.io](https://sponsor.evcc.io).
+
+#### Can I sell my token or buy a "used" one?
+
+The tokens are personalized and contain your GitHub username.
+Please do not sell them to third parties.
+Please do not buy used tokens from third parties via online platforms.
+If you want to support the project, please do so directly.
+
+#### I need a longer test time.
+
+If your test token expires and you're not sure if evcc works as expected for you, you can enter a new test token.
+We update the test token regularly.
+
+#### My token is not working. What's wrong?
+
+There could be several reasons:
+
+- **Monthly sponsoring expired:** Check your sponsor status at GitHub and [sponsor.evcc.io](https://sponsor.evcc.io).
+- **Formatting error:** Check if the token is correctly entered in the `evcc.yaml`.
+- **Experimental Config UI:** You have activated the experimental sponsor token feature in Config UI.
+In this case the token in your `evcc.yaml` is ignored and only the new database-entry is used.
+With [`evcc migrate --reset`](/docs/reference/cli/evcc_migrate) or the deletion of the `evcc.db` you can get back to the old behavior.
+
+If the above does not help, [contact us](mailto:[email protected]) and we'll check it out.
+
+#### My sponsor badge on GitHub is no longer displayed.
+
+We cannot influence the display of the sponsor badge on your GitHub profile.
+GitHub currently only displays the badge for the first month of sponsoring, even for larger one-time sponsorings.
+However, this has no influence on your sponsor status for evcc.