Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

📝 Add documentation for non-translated pages and scripts to verify them#12020

Merged
tiangolo merged 5 commits intomasterfrom
lang-reference
Aug 14, 2024
Merged

📝 Add documentation for non-translated pages and scripts to verify them#12020
tiangolo merged 5 commits intomasterfrom
lang-reference

Conversation

@tiangolo
Copy link
Member

@tiangolotiangolo commentedAug 14, 2024
edited
Loading

📝 Add documentation for non-translated pages and scripts to verify them


I realized that, for some pages, the benefit of having some translations is less beneficial than having only the original in English, because the original can change frequently, or the content is mainly injected data from external files. In those cases, the actual content translated is small, but the structure and how the data is injected can get obsolete quickly.

Also in the reference, most of the content is injected from the FastAPI source files, so, the translations are only for a small introduction at the top, but the rest of the content stays in English. And if there were new sections in the reference, those would not be visible in the translations, although the content is almost the same, all in English.

This also means that if the sections of injected data change, those translations become obsolete.

There are also sections that are mainly relevant for the internal team, or about how the project is managed, and having the most recent and precise information is more important than having it in multiple languages (that could get behind).

@github-actionsgithub-actionsbot added the docsDocumentation about how to use FastAPI labelAug 14, 2024
@tiangolotiangolo changed the title📝 Update docs for translations, don't translate some sections📝 Add documentation for non-translated pages and scripts to verify themAug 14, 2024
@github-actions
Copy link
Contributor

📝 Docs preview for commita5a7ec2 at:https://ea412449.fastapitiangolo.pages.dev

Modified Pages

@tiangolotiangolo marked this pull request as ready for reviewAugust 14, 2024 22:56
@tiangolotiangolo merged commit85bd406 intomasterAug 14, 2024
@tiangolotiangolo deleted the lang-reference branchAugust 14, 2024 22:57
s-rigaud pushed a commit to s-rigaud/fastapi that referenced this pull requestJan 23, 2025
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

docsDocumentation about how to use FastAPI

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@tiangolo

Comments


[8]ページ先頭

©2009-2026 Movatter.jp