diff --git a/xep-0389.xml b/xep-0389.xml
index 236d67a2..502eb949 100644
--- a/xep-0389.xml
+++ b/xep-0389.xml
@@ -31,6 +31,21 @@
+
+
For example, a server may advertise a "Verify with SMS" flow and a "Verify - by Phone Call" flow that both show a dataform asking for a phone number - and then a second dataform asking for a token provided to the user in a + by Phone Call" flow that both show a data form asking for a phone number + and then a second data form asking for a token provided to the user in a text message or phone call depending on which flow the user selects.
- This document defines a type of 'jabber:x:data' which MUST always contain a - data form (an 'x' element with type 'form') as defined by &xep0004;. - Other types may be defined in the future. - For example, a challenge containing a data form might look like the - following: + After a challenge is received, the client replies to the challenge by + sending a <response/> element qualified by the 'urn:xmpp:register:0' + namespace or a cancellation as defined later in this document. + If the client sends a response, it MUST also include the payload + corresponding to the challenges 'type' element (which may be empty).
-+ This document defines a type of 'jabber:x:data' which MUST always contain a + data form (an 'x' element with type 'form') as defined by &xep0004;. +
+- After a challenge is received, the client replies to the challenge by - sending a <response/> element qualified by the 'urn:xmpp:register:0' - namespace or a cancellation as defined later in this document. - If the client sends a response, it MUST also include a payload defined by - the challenges 'type' element. - In the case of a "jabber:x:data" challenge, the payload should be a form - submission as defined by &xep0004; (an 'x' element of type 'submit'). + The response to a "jabber:x:data" challenge MUST be a form submission (an + 'x' element of type 'submit'). For instance, to reply to the data form challenge from the previous example a client might send:
-+ Challenges of the type "jabber:x:oob" MUST contain an <x/> element + qualified by the "jabber:x:oob" namespace as defined in &xep0066;. +
++ If the client sends a response to the OOB challenge it MUST be empty. +
+
@@ -528,7 +569,7 @@
This specification defines the following IBR challenge:
Upon advancement of this specification from a status of Experimental to a - status of Draft, the ®ISTRAR; shall add the following definition to the - IBR challenges registry, as described in this document: + status of Draft, the ®ISTRAR; shall add the following definitions to + the IBR challenges registry, as described in this document:
jabber:x:data
Requests that the client fill out an XEP-0004 data form.
&xep0389;, &xep0004;
+]]>
+
+ jabber:x:oob
+ Requests that the client execute a URI.
+ &xep0066;
]]>