Merge 3b44df5b1c into 8032e21418

docs/en/docs/advanced/response-change-status-code.md

@@ -2,7 +2,9 @@
 
 You probably read before that you can set a default [Response Status Code](../tutorial/response-status-code.md){.internal-link target=_blank}.
 
-But in some cases you need to return a different status code than the default.
+You also read that you signal errors (400-range status codes) by raising an `HTTPException`.
+
+But in some cases you need to return a status code other than the default or an error.
 
 ## Use case
 

docs/en/docs/tutorial/body.md

@@ -26,9 +26,9 @@ First, you need to import `BaseModel` from `pydantic`:
 
 ## Create your data model
 
-Then you declare your data model as a class that inherits from `BaseModel`.
+Then you declare your data model as a class that inherits from `BaseModel`. These classes will be the containers for the various requests and responses you intend to implement.
 
-Use standard Python types for all the attributes:
+`BaseModel` will handle the data validation of all requests and responses for you.  All you have to do is declare what type each attribute is supposed to have.  Use standard Python types for the attributes:
 
 {* ../../docs_src/body/tutorial001_py310.py hl[5:9] *}
 

docs/en/docs/tutorial/handling-errors.md

@@ -71,11 +71,11 @@ They are handled automatically by **FastAPI** and converted to JSON.
 
 ## Add custom headers
 
-There are some situations in where it's useful to be able to add custom headers to the HTTP error. For example, for some types of security.
+There are some situations in which it's useful to be able to add custom headers to the HTTP error. For example, for some types of security.
 
 You probably won't need to use it directly in your code.
 
-But in case you needed it for an advanced scenario, you can add custom headers:
+But in case you need it for an advanced scenario, you can add custom headers:
 
 {* ../../docs_src/handling_errors/tutorial002.py hl[14] *}
 

docs/en/docs/tutorial/schema-extra-example.md

@@ -24,7 +24,7 @@ That extra info will be added as-is to the output **JSON Schema** for that model
 
 //// tab | Pydantic v2
 
-In Pydantic version 2, you would use the attribute `model_config`, that takes a `dict` as described in <a href="https://docs.pydantic.dev/latest/api/config/" class="external-link" target="_blank">Pydantic's docs: Configuration</a>.
+In Pydantic version 2, you would use the attribute `model_config`, which formats the behavior of an entire model, as opposed to `Field` which formats the behavior of individual attributes. The `model_config` takes a `dict` as described in <a href="https://docs.pydantic.dev/latest/api/config/" class="external-link" target="_blank">Pydantic's docs: Configuration</a>.
 
 You can set `"json_schema_extra"` with a `dict` containing any additional data you would like to show up in the generated JSON Schema, including `examples`.