🌐 [i18n-DE] Translate docs to German

[martinbrose]

References #1645

Key features

• Translates main README to German;
• Translates the main landing docs (index, installation, quick-start) to German;
• Translates the How-To-Guides (./guides) to German

[HuggingFaceDocBuilderDev]

The documentation is not available anymore as the PR was closed or merged.

[Wauplin]

Wow, thanks for the impressive effort on the translation @martinbrose ! I'll have a look to the PR (at least for the structure) once the current release is done.

[Wauplin]

Gently pinging @patrickvonplaten @philschmid if you have time for a German-docs review 🤗

[patrickvonplaten]

Sehr gut!

[BenjaminBossan]

Total unwichtig, aber ich finde "der [Hugging Face] Hub" klingt merkwürdig, ich hätte "das Hub" verwendet. "Der Hub" klingt so wie die Substantivierung von "Heben", also wie singular "Hub", plural "Hübe".

Ich hätte auch eher die Du-Form gewählt als die Sie-Form.

[Wauplin]

Thanks for the contribution @martinbrose 🤗

I only reviewed the technical aspect of the PR which overall looks good (see comments). One more thing to do is to update the github config so that the DE docs get built. You need to update this workflow and this one to add "de" as a language (as done in transformers). Thanks in advance!

[martinbrose]

Total unwichtig, aber ich finde "der [Hugging Face] Hub" klingt merkwürdig, ich hätte "das Hub" verwendet. "Der Hub" klingt so wie die Substantivierung von "Heben", also wie singular "Hub", plural "Hübe".

Ich hätte auch eher die Du-Form gewählt als die Sie-Form.

Hi @BenjaminBossan,

danke für Dein Feedback!

Ich hatte auch erst bei dem richtigen Artikel für Hub gestutzt.
Aber denke "der Hub" stimmt mit dem Duden überein, welcher dies für zwei Varianten so benutzt:

1. der Hub als der zentrale Umschlagplatz / der Knotenpunkt
2. der Hub als der Digital Hub

Bei dem "Du" vs "Sie" habe ich mich an der deutschen Übersetzung der Transformers Bibliothek orientiert: https://huggingface.co/docs/transformers/v4.33.0/de/quicktour
Aber ich ändere es auch gerne zu "Du" falls wir zu dem Konsens kommen.

Viele Grüsse

[BenjaminBossan]

Bei dem "Du" vs "Sie" habe ich mich an der deutschen Übersetzung der Transformers Bibliothek orientiert: https://huggingface.co/docs/transformers/v4.33.0/de/quicktour
Aber ich ändere es auch gerne zu "Du" falls wir zu dem Konsens kommen.

So maybe a more general question to the others: Do we prefer the more formal German "Sie" or the informal German "du"? It's like "vous" vs "tu" in French. The transformers docs use "Sie" and "vous" but IMHO it sounds very old school and incongruent with the general tone we use.

Ich hatte auch erst bei dem richtigen Artikel für Hub gestutzt.
Aber denke "der Hub" stimmt mit dem Duden überein, welcher dies für zwei Varianten so benutzt:

TIL!

[Wauplin]

So maybe a more general question to the others: Do we prefer the more formal German "Sie" or the informal German "du"? It's like "vous" vs "tu" in French. The transformers docs use "Sie" and "vous" but IMHO it sounds very old school and incongruent with the general tone we use.

So I went to read French docs in transformers (and some Google docs) to get an idea. It feels formal but I'm fine with it TBH. It has more or less the same tone as reading a recipe so I was not shocked by it. I'd say both are fine for me, with a slight preference for keeping the same tone as the existing HF 🇩🇪 docs (so "Sie"?).
In any case, it's not that much of a big deal IMO. @martinbrose you've done the work, I trust you to chose whichever you feel the most comfortable with.

[Wauplin]

Thanks for making the changes @martinbrose ! PR looks almost good to merge for me. Last thing to do, could you update the github workflow files to add "de" as a supported language as describe in #1646 (review)? Thanks in advance!

[martinbrose]

Thanks for making the changes @martinbrose ! PR looks almost good to merge for me. Last thing to do, could you update the github workflow files to add "de" as a supported language as describe in #1646 (review)? Thanks in advance!

Done.

[martinbrose]

So maybe a more general question to the others: Do we prefer the more formal German "Sie" or the informal German "du"? It's like "vous" vs "tu" in French. The transformers docs use "Sie" and "vous" but IMHO it sounds very old school and incongruent with the general tone we use.

So I went to read French docs in transformers (and some Google docs) to get an idea. It feels formal but I'm fine with it TBH. It has more or less the same tone as reading a recipe so I was not shocked by it. I'd say both are fine for me, with a slight preference for keeping the same tone as the existing HF 🇩🇪 docs (so "Sie"?). In any case, it's not that much of a big deal IMO. @martinbrose you've done the work, I trust you to chose whichever you feel the most comfortable with.

Ok, I leave it at "Sie" for now. It's an easy change to "Du" if this is decided further along.

[BenjaminBossan]

Ok, I leave it at "Sie" for now. It's an easy change to "Du" if this is decided further along.

This is a good job for an LLM ;-)

[Wauplin]

Final review done! Thanks for the effort @martinbrose, it's time to merge and publish that 🎉 🎉 🎉