Add note in docs about using integer keys.

1 files changed, 4 insertions, 0 deletions

diff --git a/src/lib.rs b/src/lib.rs
index dff822e..b7eee87 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -22,6 +22,10 @@
 //! However, after the top level you should find all supported types can be
 //! de/serialized.
 //!
+//! Note that integer keys are reserved for array indices. That is, a string of
+//! the form `a[0]=1&a[1]=3` will deserialize to the ordered sequence `a =
+//! [1,3]`.
+//!
 //! ## Usage
 //!
 //! See the examples folder for a more detailed introduction.