Changeset 44805 for trunk/doc-new


Ignore:
Timestamp:
Jan 3, 2009, 5:57:12 AM (10 years ago)
Author:
raimue@…
Message:

guide:
Move wiki TracTicketing into the guide to consolidate information

File:
1 edited

Legend:

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

    r43073 r44805  
    55  <title>MacPorts Project</title>
    66
    7   <para>The MacPorts Project uses a system called <ulink
    8   url="http://trac.edgewall.org/">Trac</ulink> to file tickets to report bugs
    9   and enhancement requests. Trac also provides an interface to browse the
    10   <ulink url="http://trac.macports.org/browser/">MacPorts
    11   Subversion repository</ulink>. Though anyone may search Trac for tickets,
    12   you must <ulink
    13   url="https://trac.macports.org/auth/register/">register</ulink> for a Trac
    14   account to create tickets.</para>
    15 
    167  <section id="project.tickets">
    17     <title>Creating Trac Tickets</title>
    18 
    19     <para>Once you are logged into Trac, you may click <ulink
    20     url="http://trac.macports.org/newticket">New Ticket</ulink> and you
    21     will be presented with a new ticket window shown in the graphic below.
    22     Follow the Trac ticket guidelines below to fill out the form.</para>
    23 
    24     <screenshot>
    25       <screeninfo>A new Trac ticket</screeninfo>
    26 
    27       <mediaobject>
    28         <imageobject>
    29           <imagedata fileref="trac-default.png" />
    30         </imageobject>
    31       </mediaobject>
    32     </screenshot>
     8    <title>Using Trac for tickets</title>
     9
     10    <para>The MacPorts Project uses a system called <ulink
     11    url="http://trac.edgewall.org/">Trac</ulink> to file tickets to report bugs
     12    and enhancement requests. Trac also provides an interface to browse the
     13    <ulink url="http://trac.macports.org/browser/">MacPorts
     14    Subversion repository</ulink>. Though anyone may search Trac for tickets,
     15    you must <ulink
     16    url="https://trac.macports.org/auth/register/">register</ulink> for a Trac
     17    account to create tickets.</para>
     18
     19    <section id="project.tickets.prerequisites">
     20      <title>Before you file a new ticket</title>
     21
     22      <itemizedlist>
     23        <listitem>
     24          <para>Check the Problem HotList</para>
     25          <para>
     26            The <ulink
     27              url="http://trac.macports.org/wiki/ProblemHotlist">Problem
     28              Hotlist</ulink> contains possible solutions to problems that
     29            affect many MacPorts users. If a solution to your problem listed
     30            there works, don't file a ticket.
     31          </para>
     32        </listitem>
     33        <listitem>
     34          <para>Search to see if a Trac ticket has already been filed</para>
     35          <para>
     36            Avoid filing duplicate bugs. Search for duplicates by:
     37            <itemizedlist>
     38              <listitem>using the search bar that appears on each page</listitem>
     39              <listitem>using <ulink url="http://trac.macports.org/projects/macports/search">the search page</ulink></listitem>
     40              <listitem>browsing the list of <ulink url="http://trac.macports.org/report">categorised reports</ulink></listitem>
     41              <listitem>making an advanced search by constructing a <ulink url="http://trac.macports.org/query">custom query</ulink></listitem>
     42            </itemizedlist>
     43          </para>
     44        </listitem>
     45        <listitem>
     46          <para>Is the problem an application error and not related to compiling and installing?</para>
     47          <para>
     48            In general, application bugs should be reported to the developers of the app
     49            ("upstream"), not MacPorts. An application bug that affects a large number of
     50            MacPorts users might merit a MacPorts bug for informational purposes only, but
     51            this should be done sparingly.
     52          </para>
     53        </listitem>
     54        <listitem>
     55          <para>Is the problem with a 'port upgrade' operation?</para>
     56          <para>
     57            If so, try a 'port uninstall <replaceable>foo</replaceable>' and
     58            then reinstall. You might also want to run 'port -fR upgrade
     59            <replaceable>foo</replaceable>' to rebuild ports depending upon
     60            port <replaceable>foo</replaceable>.
     61          </para>
     62        </listitem>
     63      </itemizedlist>
     64    </section>
     65
     66    <section id="project.tickets.creating">
     67      <title>Creating Trac Tickets</title>
     68
     69      <para>Once you are logged into Trac, you may click <ulink
     70      url="http://trac.macports.org/newticket">New Ticket</ulink> and you
     71      will be presented with a new ticket window shown in the graphic below.
     72      Follow the Trac ticket guidelines below to fill out the form.</para>
     73
     74      <screenshot>
     75        <screeninfo>A new Trac ticket</screeninfo>
     76
     77        <mediaobject>
     78          <imageobject>
     79            <imagedata fileref="trac-default.png" />
     80          </imageobject>
     81        </mediaobject>
     82      </screenshot>
     83    </section>
    3384
    3485    <section id="project.tickets.guidelines">
Note: See TracChangeset for help on using the changeset viewer.