fastapi/docs
sankarebarri 9309edc486
Minor clarification suggestion for the “Parallel Burgers” analogy in concurrency docs
Hi 👋
The burgers analogy is one of the clearest explanations of async/concurrency I’ve seen.

I wanted to raise a small pedagogical point regarding the “Parallel Burgers” section.

While the analogy does highlight why parallelism is not ideal for I/O-bound workloads, it may unintentionally give readers the impression that parallelism itself is inefficient or inherently worse than concurrency, rather than simply better suited for CPU-bound work.

In particular, the example emphasises waiting and idle time, whereas true parallelism is most beneficial when multiple workers are actively doing computation simultaneously.

A small clarification (or an alternative example where multiple cooks actively work on different parts of the task at the same time) might help reinforce that distinction.

This is a minor point, but I thought it could help avoid confusion for readers learning these concepts for the first time.

Thanks again for the great docs!
2025-12-23 19:02:11 +00:00
..
de ⚰️ Remove Python 3.8 from CI and remove Python 3.8 examples from source docs (#14559) 2025-12-17 21:41:43 +01:00
en Minor clarification suggestion for the “Parallel Burgers” analogy in concurrency docs 2025-12-23 19:02:11 +00:00
es ⚰️ Remove Python 3.8 from CI and remove Python 3.8 examples from source docs (#14559) 2025-12-17 21:41:43 +01:00
fr 🔧 Add LLM prompt file for French, generated from the existing French docs (#14544) 2025-12-17 11:41:43 +01:00
ja 🔧 Add LLM prompt file for Japanese, generated from the existing translations (#14545) 2025-12-20 18:30:52 +01:00
ko 🔧 Add LLM prompt file for Korean, generated from the existing translations (#14546) 2025-12-20 18:32:05 +01:00
pt ⚰️ Remove Python 3.8 from CI and remove Python 3.8 examples from source docs (#14559) 2025-12-17 21:41:43 +01:00
ru ⚰️ Remove Python 3.8 from CI and remove Python 3.8 examples from source docs (#14559) 2025-12-17 21:41:43 +01:00
tr 📝 Replace `starlette.io` by `starlette.dev` and `uvicorn.org` by `uvicorn.dev` (#14176) 2025-10-11 17:48:49 +00:00
uk 🔧 Add LLM prompt file for Ukrainian, generated from the existing translations (#14548) 2025-12-19 13:51:53 +01:00
zh 📝 Replace `starlette.io` by `starlette.dev` and `uvicorn.org` by `uvicorn.dev` (#14176) 2025-10-11 17:48:49 +00:00
zh-hant 📝 Replace `starlette.io` by `starlette.dev` and `uvicorn.org` by `uvicorn.dev` (#14176) 2025-10-11 17:48:49 +00:00
language_names.yml 🌐 Modify the description of `zh` - Traditional Chinese (#10889) 2024-01-22 20:42:53 +01:00
missing-translation.md 📝 Update note for untranslated pages (#14257) 2025-10-30 20:50:37 +01:00