From 0d9519a77107485dff11f306d51c3da816cc0e50 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 14 Dec 2018 20:44:42 +0400
Subject: [PATCH] :memo: Add Cookie docs

---
 docs/tutorial/cookie-params.md                | 29 +++++++++++++++++++
 .../tutorial/src/cookie-params/tutorial001.py |  8 +++++
 mkdocs.yml                                    |  1 +
 3 files changed, 38 insertions(+)
 create mode 100644 docs/tutorial/cookie-params.md
 create mode 100644 docs/tutorial/src/cookie-params/tutorial001.py

diff --git a/docs/tutorial/cookie-params.md b/docs/tutorial/cookie-params.md
new file mode 100644
index 000000000..ba1756b58
--- /dev/null
+++ b/docs/tutorial/cookie-params.md
@@ -0,0 +1,29 @@
+You can define Cookie parameters the same way you define `Query` and `Path` parameteres.
+
+## Import `Cookie`
+
+First import `Cookie`:
+
+```Python hl_lines="1"
+{!./tutorial/src/cookie-params/tutorial001.py!}
+```
+
+## Declare `Cookie` parameteres
+
+Then declare the cookie parameters using the same structure as with `Path` and `Query`.
+
+The first value is the default value, you can pass all the extra validation or annotation parameteres:
+
+```Python hl_lines="7"
+{!./tutorial/src/cookie-params/tutorial001.py!}
+```
+
+!!! info
+    `Cookie` is a "sister" class of `Path` and `Query`. It also inherits from the same common `Param` class.
+
+!!! info
+    To declare cookies, you need to use `Cookie`, because otherwise the parameters would be interpreted as query parameteres.
+
+## Recap
+
+Declare cookies with `Cookie`, using the same common pattern as `Query` and `Path`.
diff --git a/docs/tutorial/src/cookie-params/tutorial001.py b/docs/tutorial/src/cookie-params/tutorial001.py
new file mode 100644
index 000000000..5a6fd30fe
--- /dev/null
+++ b/docs/tutorial/src/cookie-params/tutorial001.py
@@ -0,0 +1,8 @@
+from fastapi import Cookie, FastAPI
+
+app = FastAPI()
+
+
+@app.get("/items/")
+async def read_items(*, ads_id: str = Cookie(None)):
+    return {"ads_id": ads_id}
diff --git a/mkdocs.yml b/mkdocs.yml
index 84107b828..d9b32f0f2 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -27,6 +27,7 @@ nav:
         - Body - Multiple Parameters: 'tutorial/body-multiple-params.md'
         - Body - Schema: 'tutorial/body-schema.md'
         - Body - Nested Models: 'tutorial/body-nested-models.md'
+        - Cookie Parameters: 'tutorial/cookie-params.md'
     - Concurrency and async / await: 'async.md'
     - Deployment: 'deployment.md'