[44825] trunk/doc-new/guide/xml/project.xml
blb at macports.org
blb at macports.org
Sat Jan 3 00:41:23 PST 2009
Revision: 44825
http://trac.macports.org/changeset/44825
Author: blb at macports.org
Date: 2009-01-03 00:41:23 -0800 (Sat, 03 Jan 2009)
Log Message:
-----------
guide - update trac ticket section to match the current state of how the
form works for non-committers (ticket #16484)
Modified Paths:
--------------
trunk/doc-new/guide/xml/project.xml
Modified: trunk/doc-new/guide/xml/project.xml
===================================================================
--- trunk/doc-new/guide/xml/project.xml 2009-01-03 08:26:55 UTC (rev 44824)
+++ trunk/doc-new/guide/xml/project.xml 2009-01-03 08:41:23 UTC (rev 44825)
@@ -91,7 +91,7 @@
<itemizedlist>
<listitem>
- <para><guilabel>Short Summary:</guilabel>
+ <para><guilabel>Summary:</guilabel>
<replaceable>[port]</replaceable>
<replaceable>[version]</replaceable> <replaceable>[concise
description]</replaceable></para>
@@ -105,25 +105,7 @@
</listitem>
<listitem>
- <para><guilabel>Type:</guilabel> There are two main types of
- tickets.</para>
-
- <itemizedlist>
- <listitem>
- <para><guimenu>defect</guimenu> - The default; any port/MacPorts
- build/runtime failures and/or documentation corrections.</para>
- </listitem>
-
- <listitem>
- <para><guimenu>enhancement</guimenu> - Tickets, with or without
- patches, created to enhance something that isn't failing its
- intended purpose.</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para><guilabel>Full Description:</guilabel> All details that might
+ <para><guilabel>Description:</guilabel> All details that might
be relevant to someone reading the ticket. <ulink
url="http://trac.macports.org/wiki/WikiFormatting">Wiki
formatting</ulink> or attached log files should be used for large
@@ -137,7 +119,7 @@
}}}
</literallayout>
- <para>Submitters are advised to trim pastes and logs of any kind to what's
+ <para>Submitters are advised to trim pastes and logs of any kind to what's
really relevant to the report, as otherwise overly large submissions that
might contain redundant and/or unnecessary information might become unmanageable.
</para>
@@ -145,6 +127,24 @@
</listitem>
<listitem>
+ <para><guilabel>Type:</guilabel> There are two main types of
+ tickets.</para>
+
+ <itemizedlist>
+ <listitem>
+ <para><guimenu>defect</guimenu> - The default; any port/MacPorts
+ build/runtime failures and/or documentation corrections.</para>
+ </listitem>
+
+ <listitem>
+ <para><guimenu>enhancement</guimenu> - Tickets, with or without
+ patches, created to enhance something that isn't failing its
+ intended purpose.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para><guilabel>Priority:</guilabel> Assign a priority level to the
ticket.</para>
@@ -174,107 +174,95 @@
</listitem>
<listitem>
- <para><guilabel>Component:</guilabel> Set what part of the MacPorts
- Project the ticket is to be filed against.</para>
+ <para><guilabel>Milestone:</guilabel> This is a ticket category that
+ allows for search and sorting tickets efficiently.</para>
<itemizedlist>
<listitem>
- <para><guimenu>base</guimenu> - Tickets related to MacPorts base
- code.</para>
+ <para><guimenu>MacPorts x.y.z</guimenu> - for base-level
+ tickets which have been assigned to a particular future
+ release of MacPorts.</para>
</listitem>
<listitem>
- <para><guimenu>guide</guimenu> - Documentation enhancements and
- error corrections, or patches to the MacPorts Guide.</para>
+ <para><guimenu>MacPorts Future</guimenu> - for base-level
+ tickets which are still under consideration and have not
+ yet been assigned to a specific future release of
+ MacPorts.</para>
</listitem>
<listitem>
- <para><guimenu>ports</guimenu> - Tickets related to
- ports.</para>
+ <para><guimenu>Port Bugs</guimenu> - for tickets reporting or
+ fixing bugs in ports provided by MacPorts.</para>
</listitem>
<listitem>
- <para><guimenu>server/hosting</guimenu> - For MacPorts hosting
- & server-side issues, reserved for MacPorts PortMgr team
- members.</para>
+ <para><guimenu>Port Enhancements</guimenu> - for submissions
+ providing enhancements to ports provided by MacPorts.</para>
</listitem>
<listitem>
- <para><guimenu>website</guimenu> - MacPorts website enhancements
- and error corrections.</para>
+ <para><guimenu>Port Requests</guimenu> - for requests for ports
+ to be added to MacPorts.</para>
</listitem>
<listitem>
- <para><guimenu>wiki</guimenu> - MacPorts Wiki enhancements and
- error corrections.</para>
+ <para><guimenu>Port Submissions</guimenu> - for submissions that
+ add a port to MacPorts.</para>
</listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para><guilabel>Keywords:</guilabel> Type any keywords that might
- help when searching for tickets (portname, type of problem,
- etc).</para>
- </listitem>
-
- <listitem>
- <para><guilabel>Cc:</guilabel> Anyone else besides the ticket
- reporter and assignee who would like to be kept involved in the
- development of the ticket. Multiple email addresses should be
- separated with a comma and a space
- (i.e. <literal>you at example.org, maintainer at macports.org</literal>).</para>
- </listitem>
-
- <listitem>
- <para><guilabel>Milestone:</guilabel> This is a ticket category that
- allows for search and sorting tickets efficiently.</para>
-
- <itemizedlist>
<listitem>
- <para><guimenu>MacPorts base enhancements</guimenu> - for
- tickets requesting or providing improvements to the
- functionality of the MacPorts system.</para>
+ <para><guimenu>Port Updates</guimenu> - for submissions that
+ update a port provided by MacPorts.</para>
</listitem>
<listitem>
- <para><guimenu>MacPorts base bugs</guimenu> - for tickets
- reporting or fixing bugs in the MacPorts system.</para>
+ <para><guimenu>Website & Documentation</guimenu> - for
+ tickets relating to the documentation for MacPorts, including
+ the MacPorts guide, Wiki, man pages and the website.</para>
</listitem>
<listitem>
- <para><guimenu>Port Bugs</guimenu> - for tickets reporting or
- fixing bugs in ports provided by MacPorts.</para>
+ <para>Blank - For unclassified tickets that don't fit into any
+ of the provided milestones.</para>
</listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para><guilabel>Component:</guilabel> Set what part of the MacPorts
+ Project the ticket is to be filed against.</para>
+
+ <itemizedlist>
<listitem>
- <para><guimenu>Port Enhancements</guimenu> - for submissions
- providing enhancements to ports provided by MacPorts.</para>
+ <para><guimenu>base</guimenu> - Tickets related to MacPorts base
+ code.</para>
</listitem>
<listitem>
- <para><guimenu>Port Requests</guimenu> - for requests for ports
- to be added to MacPorts.</para>
+ <para><guimenu>guide</guimenu> - Documentation enhancements and
+ error corrections, or patches to the MacPorts Guide.</para>
</listitem>
<listitem>
- <para><guimenu>Port Submissions</guimenu> - for submissions that
- add a port to MacPorts.</para>
+ <para><guimenu>ports</guimenu> - Tickets related to
+ ports.</para>
</listitem>
<listitem>
- <para><guimenu>Port Updates</guimenu> - for submissions that
- update a port provided by MacPorts.</para>
+ <para><guimenu>server/hosting</guimenu> - For MacPorts hosting
+ & server-side issues, reserved for MacPorts PortMgr team
+ members.</para>
</listitem>
<listitem>
- <para><guimenu>Website & Documentation</guimenu> - for
- tickets relating to the documentation for MacPorts, including
- the MacPorts guide, Wiki, man pages and the website.</para>
+ <para><guimenu>website</guimenu> - MacPorts website enhancements
+ and error corrections.</para>
</listitem>
<listitem>
- <para>Blank - For unclassified tickets that don't fit into any
- of the provided milestones.</para>
+ <para><guimenu>wiki</guimenu> - MacPorts Wiki enhancements and
+ error corrections.</para>
</listitem>
</itemizedlist>
</listitem>
@@ -285,19 +273,26 @@
</listitem>
<listitem>
- <para><guilabel>Assign To:</guilabel> For tickets on ports, enter
- the email address of the port's maintainer (use <command>port info
- <portname></command> to find this). If multiple maintainers
- are listed, enter the first maintainer's email address here and
- enter the remainining maintainers' email addresses in the
- <guimenu>Cc</guimenu> field. Exclude the email address
- <email>openmaintainer at macports.org</email> if it appears.
- If the maintainer's email address is
- <email>nomaintainer at macports.org</email>, leave the field
- blank.</para>
+ <para><guilabel>Keywords:</guilabel> Type any keywords that might
+ help when searching for tickets (portname, type of problem,
+ etc).</para>
</listitem>
<listitem>
+ <para><guilabel>Cc:</guilabel> Anyone else besides the ticket
+ reporter and assignee who would like to be kept involved in the
+ development of the ticket. Multiple email addresses should be
+ separated with a comma and a space
+ (i.e. <literal>you at example.org, maintainer at macports.org</literal>).</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Port:</guilabel> For tickets on ports, enter the
+ name of the port (or ports, space-separated, when multiple are
+ affected).</para>
+ </listitem>
+
+ <listitem>
<para><guilabel>I have files to attach to this ticket:</guilabel>
Use this checkbox to attach files to the ticket immediately after
you create it. Or you can attach files later using the
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090103/876d6ef0/attachment-0001.html>
More information about the macports-changes
mailing list