German translation progress

[nilslindemann]

This is an overview over the German translation progress.

I am done with going through these documents, they are translated to German (They have PRs waiting for approval) and (currently) up-to-date, with the following exceptions:

• Docs are about to be updated:
  sql-databases.md
  testing-database.md
• Deprecated:
  async-sql-encode-databases.md
  nosql-databases-couchbase.md
  sql-databases-peewee.md
• I am too lazy (3500 lines):
  release-notes.md

Each of these PRs needs two approvals from native German speakers, before @tiangolo considers them for merging. See the green Review changes button, under the Files changed tab, on the page of a PR. More info here (DE). You may have a look at this list I created.

Thanks to @0x4Dark, @DevSpace88, @fhabers21, @JohannesJungbluth, @mawassk for translating and @creyD, @devlopersabbir, @dtleal, @DevSpace88, @fhabers21, @GeorchW, @leo-hsk, @leonlowitzki, @mattkoehne and especially @dpinezich for reviewing. ❤️

Also, a big thanks to @tiangolo, who trusted me and merged a lot of these PRs without a reviewer.

124 of 126 PRs merged.

index.md merged
features.md ... merged
learn/index.md ... merged
python-types.md ... merged
async.md ... merged
tutorial/index.md ... merged
tutorial/first-steps.md ... merged
tutorial/path-params.md ... merged
tutorial/query-params.md ... merged
tutorial/body.md ... merged
tutorial/query-params-str-validations.md ... merged
tutorial/path-params-numeric-validations.md ... merged
tutorial/body-multiple-params.md ... merged
tutorial/body-fields.md ... merged
tutorial/body-nested-models.md ... merged
tutorial/schema-extra-example.md ... merged
tutorial/extra-data-types.md ... merged
tutorial/cookie-params.md ... merged
tutorial/header-params.md ... merged
tutorial/response-model.md ... merged
tutorial/extra-models.md ... merged
tutorial/response-status-code.md ... merged
tutorial/request-forms.md ... merged
tutorial/request-files.md ... merged
tutorial/request-forms-and-files.md ... merged
tutorial/handling-errors.md ... merged
tutorial/path-operation-configuration.md ... merged
tutorial/encoder.md ... merged
tutorial/body-updates.md ... merged
tutorial/dependencies/index.md ... merged
tutorial/dependencies/classes-as-dependencies.md ... merged
tutorial/dependencies/sub-dependencies.md ... merged
tutorial/dependencies/dependencies-in-path-operation-decorators.md ... merged
tutorial/dependencies/global-dependencies.md ... merged
tutorial/dependencies/dependencies-with-yield.md ... merged
tutorial/security/index.md ... merged
tutorial/security/first-steps.md ... merged
tutorial/security/get-current-user.md ... merged
tutorial/security/simple-oauth2.md ... merged
tutorial/security/oauth2-jwt.md ... merged
tutorial/middleware.md ... merged
tutorial/cors.md ... PR
tutorial/sql-databases.md ... (docs are about to be updated)
tutorial/bigger-applications.md ... merged
tutorial/background-tasks.md ... merged
tutorial/metadata.md ... merged
tutorial/static-files.md ... merged
tutorial/testing.md ... merged
tutorial/debugging.md ... PR, depends on another PR
advanced/index.md ... merged
advanced/path-operation-advanced-configuration.md ... merged
advanced/additional-status-codes.md ... merged
advanced/response-directly.md ... merged
advanced/custom-response.md ... merged
advanced/additional-responses.md ... merged
advanced/response-cookies.md ... merged
advanced/response-headers.md ... merged
advanced/response-change-status-code.md ... merged
advanced/advanced-dependencies.md ... merged
advanced/security/index.md ... merged
advanced/security/oauth2-scopes.md ... merged
advanced/security/http-basic-auth.md ... merged
advanced/using-request-directly.md ... merged
advanced/dataclasses.md ... merged
advanced/middleware.md ... merged
advanced/sub-applications.md ... merged
advanced/behind-a-proxy.md ... merged
advanced/templates.md ... merged
advanced/websockets.md ... merged
advanced/events.md ... merged
advanced/testing-websockets.md ... merged
advanced/testing-events.md ... merged
advanced/testing-dependencies.md ... merged
advanced/testing-database.md ... (docs are about to be updated)
advanced/async-tests.md ... merged
advanced/settings.md ... merged
advanced/openapi-callbacks.md ... merged
advanced/openapi-webhooks.md ... merged
advanced/wsgi.md ... merged
advanced/generate-clients.md ... merged
deployment/index.md ... merged
deployment/versions.md ... merged
deployment/https.md ... merged
deployment/manually.md ... merged
deployment/concepts.md ... merged
deployment/cloud.md ... merged
deployment/server-workers.md ... merged
deployment/docker.md ... merged
how-to/index.md ... merged
how-to/general.md ... merged
how-to/sql-databases-peewee.md ... (deprecated)
how-to/async-sql-encode-databases.md ... (deprecated)
how-to/nosql-databases-couchbase.md ... (deprecated)
how-to/graphql.md ... merged
how-to/custom-request-and-route.md ... merged
how-to/conditional-openapi.md ... merged
how-to/extending-openapi.md ... merged
how-to/separate-openapi-schemas.md ... merged
how-to/custom-docs-ui-assets.md ... merged
how-to/configure-swagger-ui.md ... merged
reference/index.md ... merged
reference/fastapi.md ... merged
reference/parameters.md ... merged
reference/status.md ... merged
reference/uploadfile.md ... merged
reference/exceptions.md ... merged
reference/dependencies.md ... merged
reference/apirouter.md ... merged
reference/background.md ... merged
reference/request.md ... merged
reference/websockets.md ... merged
reference/httpconnection.md ... merged
reference/response.md ... merged
reference/responses.md ... merged
reference/middleware.md ... merged
reference/openapi/index.md ... merged
reference/openapi/docs.md ... merged
reference/openapi/models.md ... merged
reference/security/index.md ... merged
reference/encoders.md ... merged
reference/staticfiles.md ... merged
reference/templating.md ... merged
reference/testclient.md ... merged
fastapi-people.md ... merged
resources/index.md ... merged
project-generation.md ... merged
external-links.md ... merged
newsletter.md ... merged
about/index.md ... merged
alternatives.md ... merged
history-design-future.md ... merged
benchmarks.md ... merged
help/index.md ... merged
help-fastapi.md ... merged
contributing.md ... merged
release-notes.md ... (too much work, 3500 lines and will change often)

[T-256]

@tiangolo could open a branch for you to push your change on that branch (e.g. new-translate/German).
After all files translated, it can be pushed to main branch via a PR.

[nilslindemann]

#10625 currently is just there to provide a preview of the state of translation, to which I link above. My intent is to delete that PR, when all the other related smaller per-document-PRs (see the numbers behind the commit titles) are merged. It also contains some changes which are not yet a PR (commits without a number after them), or which are not intended to be merged (commits starting with "(Local)"). So, in its current state, it should not be merged, I would have to undo a few commits.

On the other hand, as you mention it: It would be easier for me, if these were all merged as one big PR and people can create their own PRs afterwards, improving things. From January 23, 2024 on, I will have a training as an IT specialist in Bremen for the next two years, and then I will have less time.

[T-256]

I think main branch will be crowded by merging about 120 PRs for just translated docs of a new language.
As I said above you can:

1. ask maintainer to open new branch
2. rebase all of PR's to that created branch
3. ask maintainer to review and merge PR's

when all merged, maintainer can push full documentation behind a single PR from new branch

[nilslindemann]

Oh, ok, it sounded to me as if you are one of the core devs, and you want to do it in a specific way. Otherwise, I do not think that Tiangolo wants to change the procedure, which consists of

• one PR per document ("Add a single pull request per page translated"), and
• two approvals per PR by native speakers ("For the languages I don't speak, I'll wait for several others to review the translation before merging")

[T-256]

Uh, I think it could be better, but it's what it is now, it seems there is no problem for you work.

@tiangolo you can check my proposed suggestion for document PRs, it could be less crowded on main branch.

[nilslindemann]

For now, you can also filter the list, for example:

• is:open is:pr -author:nilslindemann hides my PRs
• is:open is:pr NOT "translation" in:title hides all PRs with "translation" in the title