📝 Swap install and run code sections order in `docs/tutorial/index.md`
Description
This PR changes the order of sections in the tutorial index files across multiple language translations. It moves the "Install FastAPI" section before the "Run the code" section, which is more logical since users need to install FastAPI before they can run any code examples.
Changes
- Reordered sections in
docs/tutorial/index.mdfiles for the following languages:- English (en)
- Simplified Chinese (zh)
- Traditional Chinese (zh-hant)
- Spanish (es)
- German (de)
- Portuguese (pt)
- Indonesian (id)
- Japanese (ja)
- Korean (ko)
- Polish (pl)
- Russian (ru)
- Ukrainian (uk)
- Vietnamese (vi)
- Emoji version (em)
- French (fr)
Motivation
The original order was inconsistent with the natural flow of onboarding new users. It makes more sense to first explain how to install FastAPI before showing users how to run code examples, as installation is a prerequisite for running the code.
Checklist
- [x] I have read the Contributing Guide
- [x] Documentation content is consistent across all translations
- [x] No code examples were modified, only the section order
📝 Docs preview for commit 8f9b9433c034cc85445251339675e228c4a1e7ae at: https://0d925945.fastapitiangolo.pages.dev
Modified Pages
- https://0d925945.fastapitiangolo.pages.dev/tutorial/ - (before)
- https://0d925945.fastapitiangolo.pages.dev/de/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/em/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/es/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/fr/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/id/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/ja/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/ko/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/pl/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/pt/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/ru/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/uk/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/vi/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/zh/tutorial/ - (before) - (English)
- https://0d925945.fastapitiangolo.pages.dev/zh-hant/tutorial/ - (before) - (English)
If we’re already putting the code demo and installation guide together in the same section, why not arrange them in a way that’s more ergonomic and user-friendly?
If we’re already putting the code demo and installation guide together in the same section, why not arrange them in a way that’s more ergonomic and user-friendly?
I understand your frustration.. But to merge this we need to review it twice (I should review it carefully and approve, then Sebastián will need to take a look and take a final decision). We have a lot of PRs and limited time, so we need to set priorities.
Hope for your understanding
This pull request has a merge conflict that needs to be resolved.
📝 Docs preview for commit e1affb9aacd91244b2520ce70431ee9ad0eced01 at: https://a7a8bfcf.fastapitiangolo.pages.dev
Modified Pages
- https://a7a8bfcf.fastapitiangolo.pages.dev/tutorial/ - (before)
- https://a7a8bfcf.fastapitiangolo.pages.dev/de/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/em/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/es/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/fr/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/id/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/ja/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/ko/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/pl/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/pt/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/ru/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/uk/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/vi/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/zh/tutorial/ - (before) - (English)
- https://a7a8bfcf.fastapitiangolo.pages.dev/zh-hant/tutorial/ - (before) - (English)
This pull request has a merge conflict that needs to be resolved.