fastapi/docs/en
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
..
data 🔥 Remove external links section (#14486) 2025-12-10 12:28:40 +00:00
docs Minor clarification suggestion for the “Parallel Burgers” analogy in concurrency docs 2025-12-23 19:02:11 +00:00
overrides 🔧 Update sponsors: add Greptile (#14429) 2025-12-01 21:06:57 +01:00
mkdocs.env.yml 🔧 Upgrade Material for MkDocs and remove insiders (#14375) 2025-11-20 11:45:16 +01:00
mkdocs.yml 🔧 Temporarily disable translations still in progress, being migrated to the new LLM setup (#14555) 2025-12-17 11:44:55 +01:00