[122834] trunk/doc-new/guide/xml/project.xml

[cal at macports.org]

Revision: 122834
          https://trac.macports.org/changeset/122834
Author:   cal at macports.org
Date:     2014-07-31 08:26:43 -0700 (Thu, 31 Jul 2014)
Log Message:
-----------
guide: improve section on new submissions

Modified Paths:
--------------
    trunk/doc-new/guide/xml/project.xml

Modified: trunk/doc-new/guide/xml/project.xml
===================================================================
--- trunk/doc-new/guide/xml/project.xml	2014-07-31 15:22:23 UTC (rev 122833)
+++ trunk/doc-new/guide/xml/project.xml	2014-07-31 15:26:43 UTC (rev 122834)
@@ -340,11 +340,19 @@
     <section id="project.contributing.new">
       <title>New Ports</title>
 
-      <para>Ports are contributed by following these steps. See Ticket
-      Submission Guidelines above for a description of all fields.</para>
+      <para>Ports are contributed by following these steps. See the <link
+        linkend="project.tickets">Ticket Submission Guidelines</link> for
+      a description of all fields.</para>
 
       <orderedlist>
         <listitem>
+          <para>Please run
+            <programlisting><prompt>%%</prompt> <userinput>port lint --nitpick $portname</userinput></programlisting>
+            where <userinput>$portname</userinput> is the name of the port you
+            are submitting. Please fix any warnings and errors.</para>
+        </listitem>
+
+        <listitem>
           <para>Create a Trac ticket.</para>
         </listitem>
 
@@ -357,9 +365,19 @@
         </listitem>
 
         <listitem>
+          <para>Set the <guilabel>port</guilabel> field to the name of the new port.</para>
+        </listitem>
+
+        <listitem>
           <para>Attach the <filename>Portfile</filename> and any required
-          patchfiles to the ticket.</para>
+            patchfiles to the ticket.</para>
         </listitem>
+
+        <listitem>
+          <para>If your ticket doesn't receive any attention within a few days
+            you may email <email>macports-dev at lists.macosforge.org</email> and
+            request a review and/or commit.</para>
+        </listitem>
       </orderedlist>
     </section>
 
@@ -403,6 +421,10 @@
         </listitem>
 
         <listitem>
+          <para>Set the <guilabel>port</guilabel> field to the name of the port you want to change.</para>
+        </listitem>
+
+        <listitem>
           <para>Put the maintainer's email address into the
             <guilabel>Cc</guilabel> field. You can use
             <programlisting><prompt>%%</prompt> <userinput>port info --maintainer $portname</userinput></programlisting>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140731/2b235839/attachment.html>