Mercurial > sat_docs
changeset 76:16ce0419a0e9
xep (jid mention): added "path" in Context parent description to make it more explicit + acknowledgements section
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Sat, 16 Jan 2016 18:48:23 +0100 |
| parents | d944c37c36fe |
| children | 7b848d093c3a |
| files | xmpp/xep-proto-jid-mention.xml |
| diffstat | 1 files changed, 6 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/xmpp/xep-proto-jid-mention.xml Sat Jan 16 18:07:21 2016 +0100 +++ b/xmpp/xep-proto-jid-mention.xml Sat Jan 16 18:48:23 2016 +0100 @@ -75,7 +75,7 @@ </section2> <section2 topic='Context parents' anchor='parents'> <p>Sometime the 'uri' refers to an element which is a child of other one(s). For instance, a mentioned URI may refer to a website comment with a direct link, which is a part of a more general conversation, or PubSub URI refers to a microblog comment which is a child of another comment, itself a child of the main item.</p> - <p>In this case, it is desirable for the mentioned entity to know where is the main item, so it can understand the whole context. To deal with this, the mentioning entity MAY add a <parents/> element which MUST contain one or more <parent/> elements. Each <parent/> element MUST contain an 'uri' attribute with the URI of the parent. If more than one parents are specified, they MUST be put in order, from the more distant one to the last child just before the one specified in the main <mention/> element.</p> + <p>In this case, it is desirable for the mentioned entity to know where is the main item, so it can understand the whole context. To deal with this, the mentioning entity MAY declare the path to the uri by adding a <parents/> element which MUST contain one or more <parent/> elements. Each <parent/> element MUST contain an 'uri' attribute with the URI of the parent. If more than one parents are specified, they MUST be put in order, from the more distant one to the last child just before the one specified in the main <mention/> element.</p> <example caption='mention of Juliet in microblog comments'><![CDATA[ <message from='romeo@montage.net' to='juliet@capulet.lit' id='123'> <mention xmlns='urn:xmpp:mention:0' uri='xmpp:pubsub.montague.lit?;node=urn%3Axmpp%3Amicroblog%3A0%3Acomments%2Fdd88c9bc58886fce0049ed050df0c5f2'> @@ -271,4 +271,9 @@ </xs:schema> ]]></code> </section1> + +<section1 topic='Acknowledgements' anchor='acks'> + <p>Thanks to Adrien Cossa for his review/corrections.</p> +</section1> + </xep>