From ffd945b78fa76a053f99310e96f4a70598552022 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonas=20Sch=C3=A4fer?= <j.wielicki@sotecware.net>
Date: Tue, 23 Aug 2022 21:28:17 +0200
Subject: [PATCH] Accept inbox/bookmark-pinning.xml as XEP-0469

---
 xep-0469.xml | 118 +++++++++++++++++++++++++++++++++++++++++++++++++++
 xep.ent      |   1 +
 2 files changed, 119 insertions(+)
 create mode 100644 xep-0469.xml

diff --git a/xep-0469.xml b/xep-0469.xml
new file mode 100644
index 00000000..ccc0986c
--- /dev/null
+++ b/xep-0469.xml
@@ -0,0 +1,118 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE xep SYSTEM 'xep.dtd' [
+  <!ENTITY namespace "urn:xmpp:bookmarks-pinning:0">
+  <!ENTITY % ents SYSTEM 'xep.ent'>
+%ents;
+]>
+<?xml-stylesheet type='text/xsl' href='xep.xsl'?>
+<xep>
+<header>
+  <title>Bookmark Pinning</title>
+  <abstract>This document defines an XMPP protocol extension to allow users to pin PEP Native Bookmarks.</abstract>
+  &LEGALNOTICE;
+  <number>0469</number>
+  <status>Experimental</status>
+  <type>Standards Track</type>
+  <sig>Standards</sig>
+  <approver>Council</approver>
+  <dependencies>
+    <spec>XMPP Core</spec>
+    <spec>XMPP IM</spec>
+    <spec>XEP-0402</spec>
+  </dependencies>
+  <supersedes/>
+  <supersededby/>
+  <shortname>bookmarkspinning</shortname>
+  &edhelas;
+  <revision>
+    <version>0.1.0</version>
+    <date>2022-08-23</date>
+    <initials>XEP Editor (jsc)</initials>
+    <remark>Accepted by vote of Council on 2022-07-27.</remark>
+  </revision>
+  <revision>
+    <version>0.0.1</version>
+    <date>2020-05-17</date>
+    <initials>am</initials>
+    <remark><p>Initial version.</p></remark>
+  </revision>
+</header>
+<section1 topic='Introduction' anchor='intro'>
+  <p>The &xep0402; defines a way to store Bookmarks using user PEP nodes and brings a support for extensions</p>
+  <p>Some users might be interested to pin some important Bookmarks when managing them.</p>
+</section1>
+<section1 topic='Requirements' anchor='reqs'>
+  <p>This extensions allow clients to pin important bookmarks.</p>
+</section1>
+<section1 topic='Protocol' anchor='protocol'>
+  <p>When saving a &xep0402; pinned item the client MUST add a new 'pinned' element within the 'extensions' element having the '&namespace;' namespace.</p>
+  <example caption="Client adds a new bookmark"><![CDATA[
+<iq from='juliet@capulet.lit/balcony' type='set' id='pip1'>
+  <pubsub xmlns='http://jabber.org/protocol/pubsub'>
+    <publish node='urn:xmpp:bookmarks:1'>
+      <item id='theplay@conference.shakespeare.lit'>
+        <conference xmlns='urn:xmpp:bookmarks:1'
+                    name='The Play&apos;s the Thing'
+                    autojoin='true'>
+          <nick>JC</nick>
+          <extensions>
+            <pinned xmlns=']]>&namespace;<![CDATA['/>
+          </extensions>
+        </conference>
+      </item>
+    </publish>
+    ...
+  </pubsub>
+</iq>
+]]></example>
+</section1>
+<section1 topic='Business Rules' anchor='rules'>
+  <p> When handling a pinned item, a client SHOULD prioritize it and treat it as important. A client MAY display it using visual specificities (e.g., ordering, icon, color) to differenciate it from non-pinned items.</p>
+</section1>
+<section1 topic='Security Considerations' anchor='security'>
+  <p>See considerations in &xep0402;.</p>
+</section1>
+<section1 topic='IANA Considerations' anchor='iana'>
+  <p>This document requires no interaction with &IANA;.</p>
+</section1>
+<section1 topic='XMPP Registrar Considerations' anchor='registrar'>
+  <section2 topic='Protocol Namespaces' anchor='registrar-ns'>
+    <p>This specification defines the following XML namespace:</p>
+    <ul>
+      <li>&namespace;</li>
+    </ul>
+    <p>The &REGISTRAR; includes this namespace in the registry located at &NAMESPACES;, as described in Section 4 of &xep0053;.</p>
+  </section2>
+  <section2 topic='Protocol Versioning' anchor='registrar-versioning'>
+    &NSVER;
+  </section2>
+</section1>
+<section1 topic='XML Schema' anchor='schema'>
+  <code><![CDATA[
+<?xml version='1.0' encoding='UTF-8'?>
+
+<xs:schema
+    xmlns:xs='http://www.w3.org/2001/XMLSchema'
+    targetNamespace=']]>&namespace;<![CDATA['
+    xmlns=']]>&namespace;<![CDATA['
+    elementFormDefault='qualified'>
+
+  <xs:annotation>
+    <xs:documentation>
+      The protocol documented by this schema is defined in
+      XEP-0402: http://www.xmpp.org/extensions/xep-0402.html
+    </xs:documentation>
+  </xs:annotation>
+
+  <xs:element name='pinned' type='empty'/>
+
+  <xs:simpleType name='empty'>
+    <xs:restriction base='xs:string'>
+      <xs:enumeration value=''/>
+    </xs:restriction>
+  </xs:simpleType>
+
+</xs:schema>
+]]></code>
+</section1>
+</xep>
diff --git a/xep.ent b/xep.ent
index cc63d972..8ffc7939 100644
--- a/xep.ent
+++ b/xep.ent
@@ -1653,3 +1653,4 @@ IANA Service Location Protocol, Version 2 (SLPv2) Templates</link></span> <note>
 <!ENTITY xep0466 "<span class='ref'><link url='https://xmpp.org/extensions/xep-0466.html'>Ephemeral Messages (XEP-0466)</link></span> <note>XEP-0466: Ephemeral Messages &lt;<link url='https://xmpp.org/extensions/xep-0466.html'>https://xmpp.org/extensions/xep-0466.html</link>&gt;.</note>" >
 <!ENTITY xep0467 "<span class='ref'><link url='https://xmpp.org/extensions/xep-0467.html'>XMPP over QUIC (XEP-0467)</link></span> <note>XEP-0467: XMPP over QUIC &lt;<link url='https://xmpp.org/extensions/xep-0467.html'>https://xmpp.org/extensions/xep-0467.html</link>&gt;.</note>" >
 <!ENTITY xep0468 "<span class='ref'><link url='https://xmpp.org/extensions/xep-0468.html'>WebSocket S2S (XEP-0468)</link></span> <note>XEP-0468: WebSocket S2S &lt;<link url='https://xmpp.org/extensions/xep-0468.html'>https://xmpp.org/extensions/xep-0468.html</link>&gt;.</note>" >
+<!ENTITY xep0469 "<span class='ref'><link url='https://xmpp.org/extensions/xep-0469.html'>Bookmark Pinning (XEP-0469)</link></span> <note>XEP-0469: Bookmark Pinning &lt;<link url='https://xmpp.org/extensions/xep-0469.html'>https://xmpp.org/extensions/xep-0469.html</link>&gt;.</note>" >