Changeset 44825 for trunk/doc-new


Ignore:
Timestamp:
Jan 3, 2009, 8:41:23 AM (10 years ago)
Author:
blb@…
Message:

guide - update trac ticket section to match the current state of how the
form works for non-committers (ticket #16484)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/project.xml

    r44805 r44825  
    9292      <itemizedlist>
    9393        <listitem>
    94           <para><guilabel>Short Summary:</guilabel>
     94          <para><guilabel>Summary:</guilabel>
    9595          <replaceable>[port]</replaceable>
    9696          <replaceable>[version]</replaceable> <replaceable>[concise
     
    106106
    107107        <listitem>
    108           <para><guilabel>Type:</guilabel> There are two main types of
    109           tickets.</para>
    110 
    111           <itemizedlist>
    112             <listitem>
    113               <para><guimenu>defect</guimenu> - The default; any port/MacPorts
    114               build/runtime failures and/or documentation corrections.</para>
    115             </listitem>
    116 
    117             <listitem>
    118               <para><guimenu>enhancement</guimenu> - Tickets, with or without
    119               patches, created to enhance something that isn't failing its
    120               intended purpose.</para>
    121             </listitem>
    122           </itemizedlist>
    123         </listitem>
    124 
    125         <listitem>
    126           <para><guilabel>Full Description:</guilabel> All details that might
     108          <para><guilabel>Description:</guilabel> All details that might
    127109          be relevant to someone reading the ticket. <ulink
    128110          url="http://trac.macports.org/wiki/WikiFormatting">Wiki
     
    138120          </literallayout>
    139121
    140           <para>Submitters are advised to trim pastes and logs of any kind to what's
     122          <para>Submitters are advised to trim pastes and logs of any kind to what's
    141123          really relevant to the report, as otherwise overly large submissions that
    142124          might contain redundant and/or unnecessary information might become unmanageable.
     
    146128
    147129        <listitem>
     130          <para><guilabel>Type:</guilabel> There are two main types of
     131          tickets.</para>
     132
     133          <itemizedlist>
     134            <listitem>
     135              <para><guimenu>defect</guimenu> - The default; any port/MacPorts
     136              build/runtime failures and/or documentation corrections.</para>
     137            </listitem>
     138
     139            <listitem>
     140              <para><guimenu>enhancement</guimenu> - Tickets, with or without
     141              patches, created to enhance something that isn't failing its
     142              intended purpose.</para>
     143            </listitem>
     144          </itemizedlist>
     145        </listitem>
     146
     147        <listitem>
    148148          <para><guilabel>Priority:</guilabel> Assign a priority level to the
    149149          ticket.</para>
     
    175175
    176176        <listitem>
     177          <para><guilabel>Milestone:</guilabel> This is a ticket category that
     178          allows for search and sorting tickets efficiently.</para>
     179
     180          <itemizedlist>
     181            <listitem>
     182              <para><guimenu>MacPorts x.y.z</guimenu> - for base-level
     183              tickets which have been assigned to a particular future
     184              release of MacPorts.</para>
     185            </listitem>
     186
     187            <listitem>
     188              <para><guimenu>MacPorts Future</guimenu> - for base-level
     189              tickets which are still under consideration and have not
     190              yet been assigned to a specific future release of
     191              MacPorts.</para>
     192            </listitem>
     193
     194            <listitem>
     195              <para><guimenu>Port Bugs</guimenu> - for tickets reporting or
     196              fixing bugs in ports provided by MacPorts.</para>
     197            </listitem>
     198
     199            <listitem>
     200              <para><guimenu>Port Enhancements</guimenu> - for submissions
     201              providing enhancements to ports provided by MacPorts.</para>
     202            </listitem>
     203
     204            <listitem>
     205              <para><guimenu>Port Requests</guimenu> - for requests for ports
     206              to be added to MacPorts.</para>
     207            </listitem>
     208
     209            <listitem>
     210              <para><guimenu>Port Submissions</guimenu> - for submissions that
     211              add a port to MacPorts.</para>
     212            </listitem>
     213
     214            <listitem>
     215              <para><guimenu>Port Updates</guimenu> - for submissions that
     216              update a port provided by MacPorts.</para>
     217            </listitem>
     218
     219            <listitem>
     220              <para><guimenu>Website &amp; Documentation</guimenu> - for
     221              tickets relating to the documentation for MacPorts, including
     222              the MacPorts guide, Wiki, man pages and the website.</para>
     223            </listitem>
     224
     225            <listitem>
     226              <para>Blank - For unclassified tickets that don't fit into any
     227              of the provided milestones.</para>
     228            </listitem>
     229          </itemizedlist>
     230        </listitem>
     231
     232        <listitem>
    177233          <para><guilabel>Component:</guilabel> Set what part of the MacPorts
    178234          Project the ticket is to be filed against.</para>
     
    210266            </listitem>
    211267          </itemizedlist>
     268        </listitem>
     269
     270        <listitem>
     271          <para><guilabel>Version:</guilabel> Select the MacPorts version you
     272          are using when it is applicable.</para>
    212273        </listitem>
    213274
     
    227288
    228289        <listitem>
    229           <para><guilabel>Milestone:</guilabel> This is a ticket category that
    230           allows for search and sorting tickets efficiently.</para>
    231 
    232           <itemizedlist>
    233             <listitem>
    234               <para><guimenu>MacPorts base enhancements</guimenu> - for
    235               tickets requesting or providing improvements to the
    236               functionality of the MacPorts system.</para>
    237             </listitem>
    238 
    239             <listitem>
    240               <para><guimenu>MacPorts base bugs</guimenu> - for tickets
    241               reporting or fixing bugs in the MacPorts system.</para>
    242             </listitem>
    243 
    244             <listitem>
    245               <para><guimenu>Port Bugs</guimenu> - for tickets reporting or
    246               fixing bugs in ports provided by MacPorts.</para>
    247             </listitem>
    248 
    249             <listitem>
    250               <para><guimenu>Port Enhancements</guimenu> - for submissions
    251               providing enhancements to ports provided by MacPorts.</para>
    252             </listitem>
    253 
    254             <listitem>
    255               <para><guimenu>Port Requests</guimenu> - for requests for ports
    256               to be added to MacPorts.</para>
    257             </listitem>
    258 
    259             <listitem>
    260               <para><guimenu>Port Submissions</guimenu> - for submissions that
    261               add a port to MacPorts.</para>
    262             </listitem>
    263 
    264             <listitem>
    265               <para><guimenu>Port Updates</guimenu> - for submissions that
    266               update a port provided by MacPorts.</para>
    267             </listitem>
    268 
    269             <listitem>
    270               <para><guimenu>Website &amp; Documentation</guimenu> - for
    271               tickets relating to the documentation for MacPorts, including
    272               the MacPorts guide, Wiki, man pages and the website.</para>
    273             </listitem>
    274 
    275             <listitem>
    276               <para>Blank - For unclassified tickets that don't fit into any
    277               of the provided milestones.</para>
    278             </listitem>
    279           </itemizedlist>
    280         </listitem>
    281 
    282         <listitem>
    283           <para><guilabel>Version:</guilabel> Select the MacPorts version you
    284           are using when it is applicable.</para>
    285         </listitem>
    286 
    287         <listitem>
    288           <para><guilabel>Assign To:</guilabel> For tickets on ports, enter
    289           the email address of the port's maintainer (use <command>port info
    290           &lt;portname&gt;</command> to find this). If multiple maintainers
    291           are listed, enter the first maintainer's email address here and
    292           enter the remainining maintainers' email addresses in the
    293           <guimenu>Cc</guimenu> field. Exclude the email address
    294           <email>openmaintainer@macports.org</email> if it appears.
    295           If the maintainer's email address is
    296           <email>nomaintainer@macports.org</email>, leave the field
    297           blank.</para>
     290          <para><guilabel>Port:</guilabel> For tickets on ports, enter the
     291          name of the port (or ports, space-separated, when multiple are
     292          affected).</para>
    298293        </listitem>
    299294
Note: See TracChangeset for help on using the changeset viewer.