:memo: Update docs to improve look in GitHub

diff --git a/README.md b/README.md
index 2d743b52a21771707c89d482f81c37ef508f8f5a..d5cac0ea035f2a21dbfe8aa18d4bfda7ef395137 100644 (file)
--- a/README.md
+++ b/README.md
@@ -65,6 +65,8 @@ $ pip install uvicorn
 
 ## Example
 
+### Create it
+
 * Create a file `main.py` with:
 
 ```Python
@@ -109,7 +111,9 @@ If you don't know, check the _"In a hurry?"_ section about <a href="https://fast
 
 </details>
 
-* Run the server with:
+### Run it
+
+Run the server with:
 
 ```bash
 uvicorn main:app --debug
@@ -139,9 +143,9 @@ You will see the JSON response as:
 You already created an API that:
 
 * Receives HTTP requests in the _paths_ `/` and `/items/{item_id}`.
-* Both _paths_ take `GET` <abbr title="also known as HTTP methods"><em>operations</em></abbr>.
+* Both _paths_ take `GET` <em>operations</em> (also known as HTTP _methods_).
 * The _path_ `/items/{item_id}` has a _path parameter_ `item_id` that should be an `int`.
-* The _path_ `/items/{item_id}` has an optional _query parameter_ `q` that is a `str`.
+* The _path_ `/items/{item_id}` has an optional `str` _query parameter_ `q`.
 
 ### Interactive API docs
 

diff --git a/docs/index.md b/docs/index.md
index 2d743b52a21771707c89d482f81c37ef508f8f5a..d5cac0ea035f2a21dbfe8aa18d4bfda7ef395137 100644 (file)
--- a/docs/index.md
+++ b/docs/index.md
@@ -65,6 +65,8 @@ $ pip install uvicorn
 
 ## Example
 
+### Create it
+
 * Create a file `main.py` with:
 
 ```Python
@@ -109,7 +111,9 @@ If you don't know, check the _"In a hurry?"_ section about <a href="https://fast
 
 </details>
 
-* Run the server with:
+### Run it
+
+Run the server with:
 
 ```bash
 uvicorn main:app --debug
@@ -139,9 +143,9 @@ You will see the JSON response as:
 You already created an API that:
 
 * Receives HTTP requests in the _paths_ `/` and `/items/{item_id}`.
-* Both _paths_ take `GET` <abbr title="also known as HTTP methods"><em>operations</em></abbr>.
+* Both _paths_ take `GET` <em>operations</em> (also known as HTTP _methods_).
 * The _path_ `/items/{item_id}` has a _path parameter_ `item_id` that should be an `int`.
-* The _path_ `/items/{item_id}` has an optional _query parameter_ `q` that is a `str`.
+* The _path_ `/items/{item_id}` has an optional `str` _query parameter_ `q`.
 
 ### Interactive API docs