From f4d753620b703127c20b2e5d3e8c483035a0e80e Mon Sep 17 00:00:00 2001
From: sliptonic <shopinthewoods@gmail.com>
Date: Fri, 4 Oct 2019 15:33:42 -0500
Subject: [PATCH] :pencil: Add notes about installing python-multipart for
 forms (#574)

---
 docs/tutorial/request-files.md           | 7 +++++++
 docs/tutorial/request-forms-and-files.md | 5 +++++
 docs/tutorial/request-forms.md           | 5 +++++
 docs/tutorial/security/first-steps.md    | 7 +++++++
 4 files changed, 24 insertions(+)

diff --git a/docs/tutorial/request-files.md b/docs/tutorial/request-files.md
index e95f9b97a..3207dc076 100644
--- a/docs/tutorial/request-files.md
+++ b/docs/tutorial/request-files.md
@@ -1,5 +1,12 @@
 You can define files to be uploaded by the client using `File`.
 
+!!! info
+    To receive uploaded files, first install [`python-multipart`](https://andrew-d.github.io/python-multipart/).
+
+    E.g. `pip install python-multipart`.
+
+    This is because uploaded files are sent as "form data".
+
 ## Import `File`
 
 Import `File` and `UploadFile` from `fastapi`:
diff --git a/docs/tutorial/request-forms-and-files.md b/docs/tutorial/request-forms-and-files.md
index eb1f9967d..5c71635e5 100644
--- a/docs/tutorial/request-forms-and-files.md
+++ b/docs/tutorial/request-forms-and-files.md
@@ -1,5 +1,10 @@
 You can define files and form fields at the same time using `File` and `Form`.
 
+!!! info
+    To receive uploaded files and/or form data, first install [`python-multipart`](https://andrew-d.github.io/python-multipart/).
+
+    E.g. `pip install python-multipart`.
+
 ## Import `File` and `Form`
 
 ```Python hl_lines="1"
diff --git a/docs/tutorial/request-forms.md b/docs/tutorial/request-forms.md
index 4fe88fa49..8c64b3af8 100644
--- a/docs/tutorial/request-forms.md
+++ b/docs/tutorial/request-forms.md
@@ -1,5 +1,10 @@
 When you need to receive form fields instead of JSON, you can use `Form`.
 
+!!! info
+    To use forms, first install [`python-multipart`](https://andrew-d.github.io/python-multipart/).
+
+    E.g. `pip install python-multipart`.
+
 ## Import `Form`
 
 Import `Form` from `fastapi`:
diff --git a/docs/tutorial/security/first-steps.md b/docs/tutorial/security/first-steps.md
index 11695f622..1ed9e8c62 100644
--- a/docs/tutorial/security/first-steps.md
+++ b/docs/tutorial/security/first-steps.md
@@ -24,6 +24,13 @@ Copy the example in a file `main.py`:
 
 ## Run it
 
+!!! info
+    First install [`python-multipart`](https://andrew-d.github.io/python-multipart/).
+
+    E.g. `pip install python-multipart`.
+
+    This is because **OAuth2** uses "form data" for sending the `username` and `password`.
+
 Run the example with:
 
 ```bash