Open-source plugins voor een internationaal publiek: nl-NL + de-DE docs voor de hele Shopware-suite

De aanname die meestal niet klopt

Open-source plugins worden bijna altijd in het Engels gedocumenteerd. Voor een wereldwijd publiek is dat de juiste keuze. Voor het Shopware-ecosysteem is het minder vanzelfsprekend. De Shopware-markt is overweldigend Duitstalig: Duitsland, Oostenrijk en Duitstalig Zwitserland zijn samen de grootste afzetregio. Engels-only README's leggen agency-leads in München vlak voor de evaluatie een onnodige drempel op — vaak precies op het moment dat ze beslissen of ze überhaupt verder gaan.

Wat de Shopware Plugin Suite recent kreeg

Voor alle zeven plugin-families in de suite — Legal Pages, Newsletter, Product Encyclopedia, Multi-Brand, Seasons, Maintenance en Analytics — werden de gebruiker- en developer-facing documenten vertaald naar nl-NL en de-DE. Dat omvat:

• README.md — de installatie- en gebruiksinstructies.
• GDPR.md — privacy- en compliance-overwegingen.
• SECURITY.md — kwetsbaarhedenbeleid en disclosure-pad.
• ACCESSIBILITY.md — WCAG-status en ondersteunde a11y-features.
• WHY.md — rationale: waarom deze plugin bestaat.
• COMPARISON.md — hoe de plugin zich verhoudt tot alternatieven.

Per document drie versies: de canonieke Engelse, een nl-NL-variant en een de-DE-variant. De vertaling is geen MT-dump maar een redactionele bewerking — Duitse store-developer-conventies wijken op enkele punten af van Engelse.

De locale-switcher als bovenrand

Drie versies van een README werken alleen als de bezoeker ze ook makkelijk kan vinden. Bovenin elk document staat nu een locale-switcher: een kort EN | NL | DE-rijtje met directe links naar de andere talen. Dat lijkt triviaal maar vraagt discipline: bij elke wijziging in een tekst moeten alle drie de versies meebewegen, en de switcher moet alle bestaande locales blijven aanwijzen. Die laatste discipline is in de PR-template van elke plugin opgenomen.

Waarom dit meer is dan een gebaar

Een Duitse mid-size agency die overweegt een gratis open-source-plugin te vertrouwen voor klantwerk, leest doorgaans drie dingen voordat de install-knop wordt aangeklikt: de README, GDPR.md en COMPARISON.md. Wanneer al die drie in het Duits beschikbaar zijn, schuift de plugin in dezelfde categorie als de commerciële Duitse alternatieven. Wanneer ze alleen in het Engels staan, leest de evaluator twee paragrafen minder en haakt eerder af. De ROI van vertalen is dus geen "extra kanaal" maar het wegnemen van een vertrouwens-drempel die anders pas in de installatie zelf zichtbaar zou zijn — als hij dan nog wordt bereikt.

Onderhouden, niet eenmaal vertalen

Een vertaling is goedkoop te starten en duur te onderhouden. Het patroon dat in de Shopware Plugin Suite wordt gevolgd, is dat elke nl-NL- of de-DE-versie een directe afgeleide is van de Engelse variant: niet onafhankelijke teksten met een eigen ritme, maar consistente vertalingen waar elke release verstandige updates oplevert. De multi-locale-docs-PR's die nu in alle zeven plugin-families zijn gemerged, zetten de baseline. Toekomstige releases voegen er secties aan toe — niet in één taal, maar in drie tegelijk.