diff --git a/README.md b/README.md
index 2d743b52a..d5cac0ea0 100644
--- 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 operations.
+* Both _paths_ take `GET` operations (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 2d743b52a..d5cac0ea0 100644
--- 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 operations.
+* Both _paths_ take `GET` operations (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