From 7535a1ade8c1ee392ae1aa337821cf8f7c7c4c9a Mon Sep 17 00:00:00 2001
From: Jonas Malaco <jonas@protocubo.io>
Date: Wed, 23 Jun 2021 12:54:25 -0300
Subject: [PATCH] Note that Form cannot require data ordering (#2283)

---
 src/types/form.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/types/form.rs b/src/types/form.rs
index 44d1b952e..4ce075d99 100644
--- a/src/types/form.rs
+++ b/src/types/form.rs
@@ -80,6 +80,10 @@ use crate::{
 ///     })
 /// }
 /// ```
+///
+/// # Panics
+/// URL encoded forms consist of unordered `key=value` pairs, therefore they cannot be decoded into
+/// any type which depends upon data ordering (eg. tuples). Trying to do so will result in a panic.
 #[derive(PartialEq, Eq, PartialOrd, Ord, Debug)]
 pub struct Form<T>(pub T);