moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-24 10:12:19 -05:00
Code Issues Releases Wiki Activity

PubSub Server Info: replace data form fields with URI

Browse Source 
As per Flow's suggestion, replace two data form fields that hold a pub-sub service address and node with one field, that uses a URI to identify the same pub-sub node.
This commit is contained in:
Guus der Kinderen 2023-12-22 11:23:41 +01:00
parent 67fbffa4fa
commit 692ce44657
1 changed files with 4 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
inbox/pubsub-server-info.xml
View File

@ -46,7 +46,7 @@
</section1> </section1>
<section1 topic="Discovering Support" anchor="disco"> <section1 topic="Discovering Support" anchor="disco">
<p>Domains supporting the publication of Server Information data, as described in this document, MUST advertise the fact by announcing a &xep0030; feature of 'urn:xmpp:serverinfo:0'. This signifies that an administrative entity approved the publication of data, which is important for the opt-in mechanism described in <link url="#privacy">Privacy Considerations section</link> of this document.</p> <p>Domains supporting the publication of Server Information data, as described in this document, MUST advertise the fact by announcing a &xep0030; feature of 'urn:xmpp:serverinfo:0'. This signifies that an administrative entity approved the publication of data, which is important for the opt-in mechanism described in <link url="#privacy">Privacy Considerations section</link> of this document.</p>
<p>The pub-sub service address and node in which Server Information data is advertised SHOULD be specified using a &xep0128;. These pub-sub coordinates MUST be scoped using a FORM_TYPE of "http://jabber.org/network/serverinfo" (as specified in XEP-0157) and data form fields registered for this purpose as defined in the <link url="#registrar">XMPP Registrar Considerations section</link> of this document.</p> <p>The pub-sub service address and node in which Server Information data is advertised SHOULD be specified using a &xep0128;, using an URI as specified in section 12.22 of XEP-0060. These pub-sub coordinates MUST be scoped using a FORM_TYPE of "http://jabber.org/network/serverinfo" (as specified in XEP-0157) and data form field registered for this purpose as defined in the <link url="#registrar">XMPP Registrar Considerations section</link> of this document.</p>
<p>When the 'urn:xmpp:serverinfo:0' feature but no corresponding Service Discovery Extension is advertised, the node that is used will be a first-level leaf node using the name 'serverinfo' on the first pub-sub service advertised through service discovery.</p> <p>When the 'urn:xmpp:serverinfo:0' feature but no corresponding Service Discovery Extension is advertised, the node that is used will be a first-level leaf node using the name 'serverinfo' on the first pub-sub service advertised through service discovery.</p>
<example caption="Service Discovery information request"><![CDATA[ <example caption="Service Discovery information request"><![CDATA[
<iq type='get' <iq type='get'
@ -68,11 +68,8 @@
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/network/serverinfo</value> <value>http://jabber.org/network/serverinfo</value>
</field> </field>
<field var='serverinfo-pubsub-service'>
<value>pubsub.shakespeare.lit</value>
</field>
<field var='serverinfo-pubsub-node'> <field var='serverinfo-pubsub-node'>
<value>serverinfo</value> <value>xmpp:pubsub.shakespeare.lit?;node=serverinfo</value>
</field> </field>
</x> </x>
</query> </query>
@ -191,14 +188,10 @@
<desc> <desc>
Forms advertising the coordinates of a pub-sub service and node for publication of Server Information data. Forms advertising the coordinates of a pub-sub service and node for publication of Server Information data.
</desc> </desc>
<field
var='serverinfo-pubsub-service'
type='list-multi'
label='The address of a pub-sub service that hosts a node on which Server Information data is published.'/>
<field <field
var='serverinfo-pubsub-node' var='serverinfo-pubsub-node'
type='list-multi' type='text-single'
label='A nodeId on which Server Information data is published.'/> label='An URI (per XEP-0060 section 12.22) identifying the pub-sub node on which Server Information data is published.'/>
</form_type> </form_type>
]]></code> ]]></code>
<p>Note that the FORM_TYPE used by &xep0157; is purposefully re-used by this XEP, to circumvent the restriction of having at most one XMPP Standards Foundation defined FORM_TYPE for a service discovery identity, as defined in &xep0128;. When a service supports both features, the data in both forms SHOULD be merged into one form.</p> <p>Note that the FORM_TYPE used by &xep0157; is purposefully re-used by this XEP, to circumvent the restriction of having at most one XMPP Standards Foundation defined FORM_TYPE for a service discovery identity, as defined in &xep0128;. When a service supports both features, the data in both forms SHOULD be merged into one form.</p>