From bc82856fb68b53529179b84e1b9617110bed9245 Mon Sep 17 00:00:00 2001
From: Kevin Brown <kevin@kevin-brown.com>
Date: Sun, 13 Sep 2015 11:33:21 -0400
Subject: [PATCH] Document data object format

So far this just documents how <select> elements have their options
converted to a data object.
---
 docs/_includes/options-new/data/select.html | 26 ++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/docs/_includes/options-new/data/select.html b/docs/_includes/options-new/data/select.html
index b1b89715..b915c921 100644
--- a/docs/_includes/options-new/data/select.html
+++ b/docs/_includes/options-new/data/select.html
@@ -24,10 +24,34 @@
   </h3>
 
   <p>
-    No.
+    No. This is a limitation of the HTML specification and is not a limitation that Select2 can overcome.
   </p>
 
   <h3>
     How are <code>&lt;option&gt;</code> and <code>&lt;optgroup&gt;</code> tags serialized into data objects?
   </h3>
+
+  <p>
+    Select2 will convert the <code>&lt;option&gt;</code> tag into a data object based on the following rules.
+  </p>
+
+<pre class="prettyprint linenums">
+{
+  "id": "value attribute" || "option text",
+  "text": "label attribute" || "option text",
+  "element": HTMLOptionElement
+}
+</pre>
+
+  <p>
+    And <code>&lt;optgroup&gt;</code> tags will be converted into data objects using the following rules
+  </p>
+
+<pre class="prettyprint linenums">
+{
+  "text": "label attribute",
+  "children": [ option data object, ... ],
+  "elment": HTMLOptGroupElement
+}
+</pre>
 </section>
\ No newline at end of file