From d0e739d8f25fa28a10963c9fd81ebb699b874034 Mon Sep 17 00:00:00 2001
From: Katherine Bancroft <katherine.bancroft@gmail.com>
Date: Fri, 10 Jul 2020 02:16:46 -0700
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Add=20note=20in=20docs=20on=20or?=
 =?UTF-8?q?der=20in=20Pydantic=20Unions=20(#1591)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add note on order in Unions

* Add an example of Union order

Co-authored-by: kbanc <katherine.bancoft@gmail.com>
---
 docs/en/docs/tutorial/extra-models.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/en/docs/tutorial/extra-models.md b/docs/en/docs/tutorial/extra-models.md
index 67d4ec473..70f7aff4b 100644
--- a/docs/en/docs/tutorial/extra-models.md
+++ b/docs/en/docs/tutorial/extra-models.md
@@ -162,6 +162,9 @@ It will be defined in OpenAPI with `anyOf`.
 
 To do that, use the standard Python type hint <a href="https://docs.python.org/3/library/typing.html#typing.Union" class="external-link" target="_blank">`typing.Union`</a>:
 
+!!! note
+    When defining a <a href="https://pydantic-docs.helpmanual.io/usage/types/#unions" class="external-link" target="_blank">`Union`</a>, include the most specific type first, followed by the less specific type. In the example below, the more specific `PlaneItem` comes before `CarItem` in `Union[PlaneItem, CarItem]`.
+
 ```Python hl_lines="1 14 15 18 19 20 33"
 {!../../../docs_src/extra_models/tutorial003.py!}
 ```