Update the submission instructions to encourage submission of v3 xml. Fixes ietf-tools#3232. Commit ready for merge.

 - Legacy-Id: 18914

Author: rjsparks

ietf/settings.py

@@ -550,6 +550,7 @@ def skip_unreadable_post(record):
 IDTRACKER_BASE_URL = "https://datatracker.ietf.org"
 RFCDIFF_BASE_URL = "https://www.ietf.org/rfcdiff"
 IDNITS_BASE_URL = "https://www.ietf.org/tools/idnits"
+XML2RFC_BASE_URL = "https://xml2rfc.tools.ietf.org/experimental.html"
 
 # The name of the method to use to invoke the test suite
 TEST_RUNNER = 'ietf.utils.test_runner.IetfTestRunner'
@@ -754,6 +755,7 @@ def skip_unreadable_post(record):
 IANA_EVAL_EMAIL = "drafts-eval@icann.org"
 SESSION_REQUEST_FROM_EMAIL = 'IETF Meeting Session Request Tool <session-request@ietf.org>' 
 
+SECRETARIAT_SUPPORT_EMAIL = "support@ietf.org"
 SECRETARIAT_ACTION_EMAIL = "ietf-action@ietf.org"
 SECRETARIAT_INFO_EMAIL = "ietf-info@ietf.org"
 

ietf/templates/submit/problem-reports-footer.html

@@ -7,7 +7,8 @@
 </p>
 <p>
 
-  If you need to request manual posting of an Internet-Draft, please send the
-  draft and the reason for manual posting to <a href="mailto:idsubmission@ietf.org">idsubmission@ietf.org</a>.
+  If you run into problems submitting an Internet-Draft and need to request manual posting of an Internet-Draft, please send the
+  draft and the reason for manual posting to <a href="mailto:{{settings.SECRETARIAT_SUPPORT_EMAIL}}">{{settings.SECRETARIAT_SUPPORT_EMAIL}}</a>.
+  Be advised that manual processing always takes additional time.
 
 </p>

ietf/templates/submit/tool_instructions.html

@@ -38,18 +38,18 @@ <h2>I-D submission tool instructions</h2>
 
   <h3>Upload screen</h3>
   <p>
-    The Upload screen is the first screen that a user will see when he or she starts the I-D submission process. A user can submit four different formats of an I-D, plain text, XML, PDF, and postscript, at the same time. Failure to submit at least one of a plain-text or xml version will cause an error, and an error screen will be displayed.
+    The Upload screen is the first screen that a user will see when he or she starts the I-D submission process. A user can submit four different formats of an I-D, plain text, XML, PDF, and postscript, at the same time. Failure to submit at least one of a plain-text or xml version will cause an error, and an error screen will be displayed. A single v3 .xml source is preferred. A single v2 .xml source will be accepted. If neither of those are available, a plain-text document may be provided.
   </p>
 
   <p>
     By submitting your I-D, you are granting some rights to the IETF Trust.  Before you submit your I-D,
-    review the information on the NOTE WELL tab and <a href="https://tools.ietf.org/html/bcp78">BCP 78</a>,
+    review the information on the NOTE WELL tab and <a href="{% url 'ietf.doc.views_doc.document_html' name='rfc5378' %}">BCP 78</a>,
     "Rights Contributors Provide to the IETF Trust".
   </p>
 
   <p>
     Before you submit your I-D, it is recommended that you check it for nits
-    using the <b><a href="https://tools.ietf.org/tools/idnits/">idnits tool</a></b>.
+    using the <b><a href="{{settings.IDNITS_BASE_URL}}">idnits tool</a></b>.
   </p>
 
   <p>
@@ -165,7 +165,7 @@ <h3>Problem report</h3>
   {% include "submit/problem-reports-footer.html" %}
 
   <p>
-    The specification for this tool can be found in <a href="https://www.ietf.org/rfc/rfc4228.txt?number=4228">RFC 4228</a>.
+    The specification for this tool can be found in <a href="{% url 'ietf.doc.views_doc.document_html' name='rfc4228' %}">RFC 4228</a>.
   </p>
 
 {% endblock %}

ietf/templates/submit/upload_submission.html

@@ -21,22 +21,15 @@
   {% endif %}
 
   {% if not form.shutdown or user|has_role:"Secretariat" %}
-    <p>If you run into problems when submitting an Internet-Draft
-      using this and the following pages, you may alternatively submit
-      your draft by email to
-      <a href="mailto:internet-drafts@ietf.org">internet-drafts@ietf.org</a>.
-      However, be advised that manual processing always takes additional time.
-    </p>
-
     <p>
       By submitting your I-D, you are granting some rights to the IETF Trust.  Before you submit your I-D,
-      review the information on the NOTE WELL tab and <a href="https://tools.ietf.org/html/bcp78">BCP 78</a>,
+      review the information on the NOTE WELL tab and <a href="{% url 'ietf.doc.views_doc.document_html' name='rfc5378' %}">BCP 78</a>,
       "Rights Contributors Provide to the IETF Trust".
     </p>
 
     <p>
       Before you submit your I-D, it is recommended that you check it for nits
-      using the <b><a href="https://tools.ietf.org/tools/idnits/">idnits tool</a></b>.
+      using the <b><a href="{{settings.IDNITS_BASE_URL}}">idnits tool</a></b>.
     </p>
 
     {% include "submit/problem-reports-footer.html" %}
@@ -45,14 +38,19 @@ <h2>Upload an Internet-Draft</h2>
 
       <p>
 	 <i>
-            Either a plain-text document or a valid .xml file which can be processed by the xml2rfc
-            processor <b>must</b> be provided.
+            The best way to submit an Internet-Draft is to provide a single v3 .xml source file.
+            The datatracker will generate the .txt and other formats from that file.
+            <br/>
+            Source v3 .xml which include external files must be preprocessed through xml2rfc with
+            the <tt>--expand</tt> option, to produce a completely expanded (standalone) .xml source 
+            file for upload. 
             <br/>
-            For v3 .xml sources which include external files, this requires them to be run through xml2rfc with
-            the <tt>--expand</tt> option, to produce a completely expanded (standalone) .xml source file for
-            upload.
+            The <a href="{{settings.XML2RFC_BASE_URL}}">online conversion tool</a> can be used to
+            convert v2 .xml documents to v3. 
             <br/>
-            If no .txt file is provided, one will be generated from the .xml file.
+            A single v3 .xml source is preferred. A single v2 .xml source will be accepted. If
+            neither of those are available, a plain-text document may be provided. One of these
+            three options <b>must</b> be provided.
             <br/>
             Other file types are optional.
          </i>