From 9a0bafe030fd7a6b6bf870202540ac5004d034c3 Mon Sep 17 00:00:00 2001
From: Florian Schmaus <flo@geekplace.eu>
Date: Wed, 27 Jan 2021 18:55:20 +0100
Subject: [PATCH] XEP-0004: Clarify that <reported/> must appear first

It is important for form consuming entities which validate the form
field types that the <reported/> element appears before any <item/>
element in result forms. This is because the <reported/> element
contains the information about the field type of the fields. So if a
form has any <item/> before <reported/>, valididating entites would
need two passes to parse the form: the first pass to parse <reported/>
and the second one to parse the fields in <item/>s.

I consider this a non-breaking change, and just a clarification of the
XEP authors intention.
---
 xep-0004.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/xep-0004.xml b/xep-0004.xml
index af3beebd..f503d324 100644
--- a/xep-0004.xml
+++ b/xep-0004.xml
@@ -295,6 +295,8 @@
       <li>One and only &lt;reported/&gt; element, which can be understood as a "table header" describing the data to follow.</li>
       <li>Zero or more &lt;item/&gt; elements, which can be understood as "table cells" containing data (if any) that matches the request.</li>
     </ol>
+	<p>The &lt;reported/&gt; element MUST appear before any
+	&lt;item/&gt; element in the XML document.</p>
     <p>The syntax is as follows:</p>
     <code><![CDATA[
 <x xmlns='jabber:x:data'