From 44f214792238438dea8f3102151e8688693f9756 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 19 May 2026 22:03:58 +0200 Subject: [PATCH 1/8] i18n(de): add German gender note to index page --- src/content/docs/de/getting-started.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/content/docs/de/getting-started.mdx b/src/content/docs/de/getting-started.mdx index 0517baa89a54c..d5024be6a7a4a 100644 --- a/src/content/docs/de/getting-started.mdx +++ b/src/content/docs/de/getting-started.mdx @@ -62,6 +62,10 @@ import Discord from '~/components/Landing/Discord.astro' - [Verbessere die Navigation mit Ansichtsübergängen](/de/guides/view-transitions/) - [Verbinde ein Headless CMS mit deinem Projekt](/de/guides/cms/) + + + Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. + From 747c9b8193882e693c1a6a8c64616a5eb68aa245 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 19 May 2026 22:15:18 +0200 Subject: [PATCH 2/8] docs: add comment for future translators for the reason of additional content in this translation --- src/content/docs/de/getting-started.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/content/docs/de/getting-started.mdx b/src/content/docs/de/getting-started.mdx index d5024be6a7a4a..c39f39c4d1d81 100644 --- a/src/content/docs/de/getting-started.mdx +++ b/src/content/docs/de/getting-started.mdx @@ -63,6 +63,8 @@ import Discord from '~/components/Landing/Discord.astro' - [Verbinde ein Headless CMS mit deinem Projekt](/de/guides/cms/) + + Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. From e74d01f24c8538da809b6ba3eee08ec8204b9f6c Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 19 May 2026 22:18:47 +0200 Subject: [PATCH 3/8] fix: use right comment syntax --- src/content/docs/de/getting-started.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/de/getting-started.mdx b/src/content/docs/de/getting-started.mdx index c39f39c4d1d81..21b67052dcf13 100644 --- a/src/content/docs/de/getting-started.mdx +++ b/src/content/docs/de/getting-started.mdx @@ -63,7 +63,7 @@ import Discord from '~/components/Landing/Discord.astro' - [Verbinde ein Headless CMS mit deinem Projekt](/de/guides/cms/) - + {/* This last card is additional content in the German translation to clarify how we phrase gender-neutrality */} Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. From cb11e1d6c2dbbfe2d785a659cd9326d164e5a706 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 23 Jun 2026 20:18:35 +0200 Subject: [PATCH 4/8] Revert "fix: use right comment syntax" This reverts commit e74d01f24c8538da809b6ba3eee08ec8204b9f6c. --- src/content/docs/de/getting-started.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/de/getting-started.mdx b/src/content/docs/de/getting-started.mdx index 00baff59b2726..25924a4e16a52 100644 --- a/src/content/docs/de/getting-started.mdx +++ b/src/content/docs/de/getting-started.mdx @@ -60,7 +60,7 @@ import Discord from '~/components/Landing/Discord.astro' - [Verbinde ein Headless CMS mit deinem Projekt](/de/guides/cms/) - {/* This last card is additional content in the German translation to clarify how we phrase gender-neutrality */} + Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. From 0b689bba408041aaf14af0fffe49fe5eb106fe63 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 23 Jun 2026 20:18:37 +0200 Subject: [PATCH 5/8] Revert "docs: add comment for future translators for the reason of additional content in this translation" This reverts commit 747c9b8193882e693c1a6a8c64616a5eb68aa245. --- src/content/docs/de/getting-started.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/content/docs/de/getting-started.mdx b/src/content/docs/de/getting-started.mdx index 25924a4e16a52..b7ed1de012bed 100644 --- a/src/content/docs/de/getting-started.mdx +++ b/src/content/docs/de/getting-started.mdx @@ -60,8 +60,6 @@ import Discord from '~/components/Landing/Discord.astro' - [Verbinde ein Headless CMS mit deinem Projekt](/de/guides/cms/) - - Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. From 1608f8405d34e9cf2c6d247367a8b37051b70d40 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 23 Jun 2026 20:18:38 +0200 Subject: [PATCH 6/8] Revert "i18n(de): add German gender note to index page" This reverts commit 44f214792238438dea8f3102151e8688693f9756. --- src/content/docs/de/getting-started.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/src/content/docs/de/getting-started.mdx b/src/content/docs/de/getting-started.mdx index b7ed1de012bed..6e2c214fac8c6 100644 --- a/src/content/docs/de/getting-started.mdx +++ b/src/content/docs/de/getting-started.mdx @@ -59,10 +59,6 @@ import Discord from '~/components/Landing/Discord.astro' - [Verbessere die Navigation mit Ansichtsübergängen](/de/guides/view-transitions/) - [Verbinde ein Headless CMS mit deinem Projekt](/de/guides/cms/) - - - Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. - From 7ea4219f991a840938f300e03684cd3f68caf450 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Tue, 23 Jun 2026 20:19:11 +0200 Subject: [PATCH 7/8] docs: include gender notice in i18n guide Co-authored-by: Chris Swithinbank <357379+delucis@users.noreply.github.com> --- i18n-guides/deutsch.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n-guides/deutsch.md b/i18n-guides/deutsch.md index 0cf469b4dbc97..0e62052c5310d 100644 --- a/i18n-guides/deutsch.md +++ b/i18n-guides/deutsch.md @@ -67,7 +67,7 @@ Diese Anleitung soll dazu beitragen, dass sich das Ergebnis beim Lesen trotz all - Falls die Übersetzung sich aber nicht flüssig liest, weil z. B. im Deutschen übliche Überleitungen fehlen oder andere Formulierungen geläufiger sind, kann freier übersetzt werden, so lange die Bedeutung korrekt bleibt. - Wir übersetzen alle Kommentare in Code-Beispielen. - Komponenten-, Klassen- und Variablennamen in Code-Beispielen werden nicht übersetzt. -- Wir haben uns gegen das Gendern in unserer Übersetzung entschieden, weil es die Lesbarkeit der Texte verschlechtert und noch keine Duden-Vorgaben dafür existieren. Wir vermeiden lieber geschlechtsspezifische Formulierungen in unseren Übersetzungen und formulieren die Texte so, dass niemand sich ausgeschlossen fühlen muss. +- Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. - Wir vermeiden wertende Adjektive wie „einfach“, „simpel“ usw., da es immer Personen geben wird, denen das beschriebene Thema eben nicht „einfach“ oder „simpel“ vorkommt. Wir möchten niemandem den Eindruck vermitteln, fachlich „nicht gut genug“ zu sein. - Wir übersetzen nicht zwanghaft Begriffe, die aus einem Ökosystem-spezifischen Kontext stammen. Eine Wort für Wort Übersetzung ist meistens nicht möglich, sodass eine ausführliche Erklärung folgen müsste, was wiederum die Lesbarkeit verschlechtert. Ein gutes Beispiel hierfür wären Begriffe, wie „Commit“, „Pull Request“ und „merge“, die teils einen ganzen Prozess im Git-Ökosystem beschreiben. - Bei Wörtern, die länger als 20 Zeichen sind, fügen wir generell einen weichen Bindestrich (`­`) ein. Um solche Wörter zu finden, kann der folgende reguläre Ausdruck zum Suchen im Code-Editor verwendet werden: `\b[A-Za-zÄäÖöÜüẞß]{20,}\b` From 08f541fda024f0135e4943c2b5b8f81936c3fd91 Mon Sep 17 00:00:00 2001 From: Felix Schneider <99918022+trueberryless@users.noreply.github.com> Date: Thu, 2 Jul 2026 20:38:16 +0200 Subject: [PATCH 8/8] docs: rephrase with the help of @delucis' suggestion --- i18n-guides/deutsch.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n-guides/deutsch.md b/i18n-guides/deutsch.md index 0e62052c5310d..7a734df388728 100644 --- a/i18n-guides/deutsch.md +++ b/i18n-guides/deutsch.md @@ -67,7 +67,7 @@ Diese Anleitung soll dazu beitragen, dass sich das Ergebnis beim Lesen trotz all - Falls die Übersetzung sich aber nicht flüssig liest, weil z. B. im Deutschen übliche Überleitungen fehlen oder andere Formulierungen geläufiger sind, kann freier übersetzt werden, so lange die Bedeutung korrekt bleibt. - Wir übersetzen alle Kommentare in Code-Beispielen. - Komponenten-, Klassen- und Variablennamen in Code-Beispielen werden nicht übersetzt. -- Aus Gründen der besseren Lesbarkeit wird in dieser Dokumentation auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. +- Wir streben in unseren Übersetzungen eine neutrale Ausdrucksweise an, durch die sich niemand ausgeschlossen fühlen soll. Wo neutrale Formulierungen nicht möglich sind, wird aus Gründen der besseren Lesbarkeit auf die gleichzeitige Verwendung mehrgeschlechtlicher Sprachformen verzichtet. Sämtliche Personenbezeichnungen gelten dabei als geschlechtsneutral und beziehen sich gleichermaßen auf alle Geschlechter. Unsere Gemeinschaft lebt von Vielfalt – wir legen großen Wert darauf, dass sich jede Person, unabhängig von der Identität, hier willkommen und angesprochen fühlt. - Wir vermeiden wertende Adjektive wie „einfach“, „simpel“ usw., da es immer Personen geben wird, denen das beschriebene Thema eben nicht „einfach“ oder „simpel“ vorkommt. Wir möchten niemandem den Eindruck vermitteln, fachlich „nicht gut genug“ zu sein. - Wir übersetzen nicht zwanghaft Begriffe, die aus einem Ökosystem-spezifischen Kontext stammen. Eine Wort für Wort Übersetzung ist meistens nicht möglich, sodass eine ausführliche Erklärung folgen müsste, was wiederum die Lesbarkeit verschlechtert. Ein gutes Beispiel hierfür wären Begriffe, wie „Commit“, „Pull Request“ und „merge“, die teils einen ganzen Prozess im Git-Ökosystem beschreiben. - Bei Wörtern, die länger als 20 Zeichen sind, fügen wir generell einen weichen Bindestrich (`­`) ein. Um solche Wörter zu finden, kann der folgende reguläre Ausdruck zum Suchen im Code-Editor verwendet werden: `\b[A-Za-zÄäÖöÜüẞß]{20,}\b`