XEP-0143 GitHub all the things

xep-0143.xml

@@ -22,6 +22,12 @@
   <supersededby/>
   <shortname>N/A</shortname>
   &stpeter;
+  <revision>
+    <version>1.1.3</version>
+    <date>2024-12-24</date>
+    <initials>dwd</initials>
+    <remark><p>Reflect preference for GitHub pull requests for initial submission, PRs to contain only one XEP change, </p></remark>
+  </revision>
   <revision>
     <version>1.1.2</version>
     <date>2016-12-02</date>
@@ -88,6 +94,7 @@
   <p>After completing this research, the prospective author might conclude that a new protocol extension is needed. If so, the author is strongly advised to do the following:</p>
   <ol>
     <li>Review &xep0001; and the &xep0134;.</li>
+    <li>Read, understand, and agree to the &XSFIPR;.</li>
     <li>Understand the <link url='#submit'>Submission Process</link>.</li>
     <li>Become familiar with the <link url='#format'>XEP XML Format</link>.</li>
     <li>Then and only then write a proposal that includes all of the appropriate <link url='#sections'>Sections of a XEP</link>.</li>
@@ -100,7 +107,8 @@
   <ol>
     <li>Write your proposal following the guidelines described in this document.</li>
     <li>Make sure that you read, understand, and agree to the &XSFIPR; before you submit your proposal.</li>
-    <li>Send your XML file (or a URL pointing to the file) to the &EDITOR; team via email to [email protected] (make sure that the email subject includes the string "XEP" somewhere in it!)..</li>
+    <li>Ideally: Submit your XEP via a GitHub Pull Request that adds the file (and changes no others) to the "inbox" directory. (See <link url="#maintain">below</link> for a typical working pattern.</li>
+    <li>If this cannot be done (perhaps because you have no GitHub account and do not wish to obtain one), send your XML file (or a URL pointing to the file) to the &SSIG; via email to [email protected], and request someone to help you. (There are usually people who help the &EDITOR; in this way).</li>
   </ol>
 </section1>
 
@@ -110,10 +118,12 @@
   <ol>
     <li>Create your own fork of the XSF's git repository (the address of the GitHub mirror can be found at &SOURCECONTROL;).</li>
     <li>Create a dedicated branch for these changes in your forked repository.</li>
-    <li>Make your desired changes to the document or documents, including an updated &lt;revision/&gt; element as described below.</li>
+    <li>Make your desired changes to the document, including an updated &lt;revision/&gt; element as described below.</li>
     <li>Commit and push the changes to your branch.</li>
-    <li>Create a pull request from your fork to the master branch at the GitHub mirror.</li>
+    <li>Create a pull request from your fork to the master branch at the GitHub mirror. The title of the Pull Request MUST start with the formal document identifier (eg, "XEP-0143"). Note that each pull request should change only one XEP.</li>
+    <li>Monitor CI output to ensure that errors are corrected.</li>
   </ol>
+  <p>As above, if you do not have a GitHub account, and decline to sign up for one, you will need to ask for help from someone who does.</p>
   <p>The XMPP Extensions Editor team will then process your pull request, seek Council approval if necessary, and publish an updated version of your XEP.</p>
   <p>NOTE: As explained in &xep0001;, updated versions of XEPs in the Experimental state are published without the need for approval by the XMPP Council. However, updated versions of XEPs in the Active, Draft, or Final state must be approved by the XMPP Council to ensure proper change control regarding approved protocols.</p>
 </section1>
@@ -286,7 +296,7 @@ echo -n '[email protected]' | openssl enc -nopad -base64
 </section1>
 
 <section1 topic='Acknowledgements' anchor='ack'>
-  <p>Thanks to Tobias Markmann and Kevin Smith for their input.</p>
+  <p>Thanks to Daniel Gultsch, Tobias Markmann and Kevin Smith for their input.</p>
 </section1>
 
 </xep>