Setting it to draft temporarily to run one final language translation on the current state, to test if the prompts are good.

What I have done 💪

I have let the AI retranslate all the German documents, at least twice per document, and at least once with GPT 5. In the first run I mostly used GPT 4o and a few times GPT 5, with prompt modifications in-between, learning from GPTs output (and vice versa I guess). In the second run, which was a batch run without prompt modifications in-between, I used GPT 5 (Plot twist, it does the job better ^[1]). I diffed both against the English document and the previous translation, sometimes doing global changes in the German docs on the way. I did not look at parts which were white in the previous-translation ↔ new translation diff (= unchanged parts), as I translated most of them a few months ago, reviewing them back then. But I used white parts in the English document ↔ new translation diff, to see if critical changes in the previous-translation ↔ new translation diff, like changes in code includes, are good and bring things in sync.

What the PR changes 🔨

This PR applies all changes of #13993 (merged), #13968, #13931, #13929 (closed, will be done here), #13930 (closed, will be done here) before it adds changes on top. I later apply @svlandeg's suggestions in the permalink PR (#13993) and manually fix outdated permalinks. The second batch run showed that the permalinks are in sync. The PR makes:

• heavy changes to the general prompt in the translate.py
  • Edit: Yurii applied them in 🔨 Update translations script #13968
• heavy changes to docs/de/llm-prompt.md, which is the German LLM prompt, which gets appended to the general prompt in the translate.py.
• lots of changes to the German documents under docs/de/docs, to bring them in sync with the English docs (adding a few abbrs on top)

Outdated

• It also adds/fixes some things in the code of translate.py
  • Edit: Let's handle these in another PR. they are not relevant for this PR.
• a few changes to English documents under docs/en/docs, mostly fixes.
  • Edit: I outsourced this to 📝 Fix and Improve English Documentation #14048. Those changes are assumed in the translations here, so let's resolve that other PR first.
• I have added a file docs/en/docs/_llm-test.md, which can be used to test the prompt. The German translation of it is also included
  • Edit: Let's do this in ✅ Add LLM test file #14049.

How to review 💪

The Commits start clean, but sometimes get a bit messy towards the end, especially those made late at night 😅. Sorry about that. I suggest to not go through the PR commit-by-commit, but all-in-one, by using the Files changed tab, because some files are changed more than once in more than one commit, sometimes overwriting changes of previous commits. I suggest directly comparing those German translations which have many changes with the English document.

The result 😲

After this PR, all 111 112 (I have added a test document) translatable English documents have their in-sync German translation.

Credits 🤝

Thanks to @tiangolo, @YuriiMotov, @alejsdev and everyone else for their friendly support.

Footnote 📓

^[1] GPT 5's changes are approximately 90% fixes and good changes, approximately 5% are unnecessary changes and approximately 5% are changes which have to be manually edited or reverted. GPT 4 does more unnecessary changes, resulting in, on average, twice as big diffs. GPT 5 understands complex prompt instructions better than GPT 4 and applies them more precise.