head	1.6;
access;
symbols
	TIGRIS_1_1_0RC2:1.4
	TIGRIS_1_1_0RC1:1.4
	TIGRIS_1_1:1.4.0.4
	TIGRIS_1_0_8:1.4
	TIGRIS_1_0_8RC3:1.4
	TIGRIS_1_0_8RC2:1.4
	TIGRIS_1_0_8RC1:1.4
	TIGRIS_1_0_7:1.4
	TIGRIS_1_0_7RC3:1.4
	TIGRIS_1_0_7RC2:1.4
	TIGRIS_1_0_7RC1:1.4
	TIGRIS_1_0_6:1.4
	TIGRIS_1_0_6RC5:1.4
	TIGRIS_1_0_6RC4:1.4
	TIGRIS_1_0_6RC3:1.4
	TIGRIS_1_0_6RC2:1.4
	TIGRIS_1_0_6RC1:1.4
	TIGRIS_1_0_5:1.4
	TIGRIS_1_0_5RC6:1.4
	TIGRIS_1_0_5RC5:1.4
	TIGRIS_1_0_5RC4:1.4
	TIGRIS_1_0_5RC3:1.4
	TIGRIS_1_0_5RC2:1.4
	TIGRIS_1_0_5RC1:1.4
	TIGRIS_1_0_4:1.4
	TIGRIS_1_0_3:1.4
	TIGRIS_1_0_2:1.4
	TIGRIS_1_0_1:1.4
	TIGRIS_1_0:1.4.0.6
	TIGRIS_1_0_0:1.4
	TIGRIS_1_0_0_RC1:1.4.0.2;
locks; strict;
comment	@# @;


1.6
date	2001.06.21.07.07.40;	author jefflove;	state Exp;
branches;
next	1.5;

1.5
date	2001.06.11.03.14.33;	author jefflove;	state Exp;
branches;
next	1.4;

1.4
date	2001.03.16.23.50.52;	author lori;	state Exp;
branches;
next	1.3;

1.3
date	2001.02.11.18.29.47;	author jrobbins;	state Exp;
branches;
next	1.2;

1.2
date	2001.02.09.00.59.20;	author susank;	state Exp;
branches;
next	1.1;

1.1
date	2001.01.29.19.41.02;	author lori;	state Exp;
branches;
next	;


desc
@@


1.6
log
@html usage revision
@
text
@  <div class="docs" id="ddissuesentermodify">
   <h2>Entering and modifying issues</h2>

   <div class="toc">
    <h3>More help on IssueZilla: Index</h3>

    <ul>
     <li>
      <a href="ProjectIssues.html">Project issue tracking</a> 

      <ul>
       <li>
        <strong>You are here:</strong> Entering and modifying issues 

        <ul>
         <li><a href="#enterissue">Entering a new issue</a></li>

         <li><a href="#entryfields">Issue entry field descriptions</a></li>

         <li><a href="#editissue">Viewing and modifying issues</a></li>
        </ul>
       </li>

       <li><a href="ddIssues_Query.html">Querying and tracking issues</a></li>

       <li><a href="ddIssues_Reports.html">Generating status reports about project issues</a></li>
      </ul>
     </li>
    </ul>

    <h3>More help about issues</h3>

    <ul>
     <li><a href="issuewritinghelp.html">Issue writing guidelines</a></li>

     <li><a href="contributing_patches.html">Contributing patches</a></li>

     <li><a href="issue_lifecycle.html">The lifecycle of an issue</a></li>

     <li><a href="issues_unconfirmedhelp.html">Understanding the UNCONFIRMED issue state</a></li>
    </ul>
   </div>

   <div class="courtesylinks">
    <p><a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>

   <h3><a id="enterissue" name="enterissue">Entering a new issue</a></h3>

   <ul>
    <li>Choose the appropriate link in the "Enter An Issue" section of the Project Issues page. Once you have invoked IssueZilla, a secondary "Issue Tracking" tool bar appears on this page and you can also enter an issue by clicking the <i>New</i> link in the IssueZilla tool bar.</li>

    <li>Choose the appropriate project component.</li>

    <li>Selected the appropriate options or input information for each field before using the <i>Commit</i> button to enter your issue.</li>
   </ul>

   <p>The information you provide here significantly determines the effectiveness of your issue reports and the response to them. Descriptions for each of these fields follow to help you optimize your issue reports.</p>

   <p><b>Important note</b>: When you first enter a new issue, you cannot set a target milestone date, nor can you assign dependencies (flag other issues that depend on this new issue or those that it depends upon). To designate a target milestone or dependencies, you must first submit the new issue successfully, then retrieve it to access fields for setting a target milestone and creating dependencies.</p>

   <h3><a id="entryfields" name="entryfields">Issue entry field descriptions</a></h3>

   <dl>
    <dt>Version</dt>

    <dd>The release in which you identified this issue or found the defect.</dd>

    <dt>Component/Sub Component</dt>

    <dd>Identify area within the project that this issue is associated with. Only one selection is permitted.</dd>

    <dt>Platform</dt>

    <dd>
     This corresponds to <i>your</i> hardware platform when you are reporting a defect. Options include: 

     <ul>
      <li>All (happens on all platform; cross-platform issue)</li>

      <li>Macintosh</li>

      <li>PC</li>

      <li>Sun</li>

      <li>HP</li>
     </ul>
     <b>Note:</b> Selecting the option "All" does not select issues assigned against all platforms. It merely selects issues that <i>occur</i> on all platforms.
    </dd>

    <dt>Operating System</dt>

    <dd>
     This is the operating system against which the issue is being reported. Legal operating systems include: 

     <ul>
      <li>All (happens on all operating systems, making this a cross-platform issue)</li>

      <li>Windows 95</li>

      <li>Mac System 8.0</li>

      <li>Linux</li>
     </ul>
     Note that the operating system implies the platform, but not always. For example, Linux can run on PC, Macintosh, and others.
    </dd>

    <dt>Priority</dt>

    <dd>
     This field let you assign a level of importance to help determine when this issue should be addressed relative to other issues. This field is utilized by the programmers/engineers to prioritize their work. 

     <ul>
      <li>P1 - Most important</li>

      <li>P2</li>

      <li>P3</li>

      <li>P4</li>

      <li>P5 - Least important</li>
     </ul>
    </dd>

    <dt>Issue Type</dt>

    <dd>
     <p><em>Defect</em> is a problem with an existing feature that is either not developed to spec or does not work as designed. These are often referred to as "bugs."</p>

     <p><em>Enhancement</em> is an improvement to an existing feature.</p>

     <p><em>Feature</em> is an addition to the software to add a piece of functionality that does not yet exist.</p>

     <p><em>Task</em> is an activity to be done on behalf or in support of a feature or enhancement. Tasks do not typically require direct changes to the code base.</p>

     <p><em>Patch</em> is a special kind of issue, a section of code to be applied or attached to existing software, often to fix a defect.</p>
    </dd>

    <dt>Initial state</dt>

    <dd>Newly entered issues are either "new" or "unconfirmed." Marking an issue <a href="/docs/issues_unconfirmedhelp.html">unconfirmed</a> means you have not yet determined whether it is true or valid. Read more about "state" in the <a href="issue_lifecycle.html">lifecycle of an issue</a>.</dd>

    <dt>Assigned To</dt>

    <dd>Enter the email address of the one individual who is in charge of resolving the issue. If this field is left blank, the issue by default is assigned to the component/sub component owner. Every time this field changes, the status changes to <b>NEW</b> to make it visible in the assignee's list of issues.</dd>

    <dt>Cc:</dt>

    <dd>
     Add email addresses of other individuals who need email notification when this issue changes status or when there is other activity on this issue. Delimit multiple email addressees by single spaces only -- no commas or semi-colons are necessary. 

     <p>Note: Assign cc addresses sparingly. Project participants whose interest or involvement in this issue is peripheral should be encouraged to use IssueZilla to check and track issues rather than to rely on automatic email notification.</p>
    </dd>

    <dt>URL</dt>

    <dd>
     How to use this field depends on the issue type: 

     <ul>
      <li>For defects, URL should lead to a fairly stable system where the the problem is obvious or can be easily reproduced.</li>

      <li>For enhancements, URL should provide details pertaining to the improvement, such as mockups.</li>

      <li>For features, URL should link to any web-based form of material explaining the improvement such as mockups or design specs.</li>

      <li>For tasks, URL is optional and may include linking to the associated feature or enhancement.</li>
     </ul>
    </dd>

    <dt>Summary</dt>

    <dd>A terse, specific statement to describe this issue. This should a few unique, self-explanatory words to identify this issue easily in reports and short lists. Limiting your entry to the width of the field is best for the columnar display of query results.</dd>

    <dt>Description</dt>

    <dd>Provide a full description of the issue including any pertinent history or activity around this issue. Because this field is additive, it serves as the knowledge base and means of communicating through this issue's life cycle. Other project participants view and add comments or information using this field.</dd>
   </dl>

   <h3>After completing all necessary fields:</h3>

   <p><em>Commit</em> enters this issue into the project's issue database.</p>

   <p><em>Reset</em> returns all field values to their default or blank settings.</p>

   <p><em>Remember values as bookmark template</em> lets you save your input settings to save keystrokes when entering multiple issues for the same project component.</p>

   <p>For more information about entering issues into IssueZilla, see also <a href="issuewritinghelp.html">Issue Writing Guidelines</a>.</p>

   <h3>Viewing and modifying issues</h3>

   <p>Existing issues may be accessed in two different ways:</p>

   <ul>
    <li>Entering a specific issue number in the "Find" field located in the IssueZilla tool bar displays the "Issue View" page.</li>

    <li>Querying for issues either by clicking the "Query database" button in the Project Issues page, or by clicking the "Query" link in the IssueZilla tool bar displays an "Issue List" page of your results. (See <a href="ddIssues_Query.html">Querying and tracking issues</a>.)</li>
   </ul>

   <p>The Issue View page is similar to the Issue Entry page and contains many of the same fields, but there are several important additions:</p>

   <dl>
    <dt>Target Milestone</dt>

    <dd>If your project has designated milestones, this field can be used to associated issues with those milestones, such as version releases. A milestone plan enumerates when different features are expected to be completed. If an issue has a target date or version release, this means the work on this issue must be completed by that date. This field should only be set or changed by the person responsible for the issue.</dd>

    <dt>Add/Remove CC:</dt>

    <dd>You can add additional email addresses to this issue to alert other project members when activity occurs on this issue. If you are adding multiple addresses, delimit these with single spaces; do not use commas or semi-colons. You can also <i>remove</i> one or more email address listed by selecting it and checking the "Remove selected Cc's" box below.</dd>

    <dt>QA Contact</dt>

    <dd>This field should contain an email address or alias for the person(s) responsible for quality control of this issue.</dd>

    <dt>URL</dt>

    <dd>If this field is populated, clicking the field label links directly to the designated URL.</dd>

    <dt>Status Whiteboard</dt>

    <dd>The purpose of this generic field can be user-defined and project-specific. (In BugZilla, this field is used for writing short, one-line notes about the bug.)</dd>

    <dt>Attachments</dt>

    <dd>
     Adding attachment to an issue can be very useful. For defects, appending test cases, screen shots and/or editor logs to the issue can help pinpoint the problem to help the developer reproduce it. 

     <p>For features, enhancements, and tasks, you can attach screen shots, mockups, and other files to provide supplemental information to illustrate the issue.</p>

     <p>You can also used this field to attach a patch related to the issue when appropriate. Read more about <a href="contributing_patches.html">contributing patches</a>.</p>
    </dd>

    <dt>Dependencies</dt>

    <dd>When an issue can't be addressed until one or more other issues are resolved, these are dependencies. Each issue can have other issues it depends upon , as well as issues that depend upon it, that is, other issues that this issue "blocks" while being unresolved. The links next to these fields display a tree and graph illustrating the dependencies associated with the issue currently being viewed.</dd>

    <dt>Vote for this issue</dt>

    <dd>
     <!-- (adapted from bugzilla.mozilla.org's "Bugzilla Voting" page) -->
     IssueZilla's "voting" feature allows project members to have a certain number of votes in their project to use toward issues. Project owners set the number of votes allowed per issue, as well as the number of votes allowed per member. Some projects/components may not allow any, which means you can't vote on those issues at all. Your vote indicates which issues you believe are the most important to be addressed. 

     <p>You may vote for the same bug more than once, however, you have a limited number of total votes allocated to you. You can either vote once for many issues, or use multiple votes for a fewer issues that you think are particularly critical.</p>

     <p>If an issue has received votes, the total number appears next to "Votes for this issue", or "0" if no votes have been logged. Clicking on this number displays the Show Votes page. If there are votes, names and their associated number of votes are listed.</p>

     <p>To view a list of issues that have received votes, use the IssueZilla Query page, and enter the numeral "1" in the "At least ___ votes" field. This returns issues in your query results with at least one vote.</p>

     <p>To vote for an issue:</p>

     <ul>
      <li>Open the issue (using the "Find" link in the tool bar or by clicking the issue from a list or report).</li>

      <li>Click on the "Vote for this issue" link just above the "Additional Comments" field. (If no such link appears, then voting may not be allowed for this issue's project/component.)</li>

      <li>Indicate the number of votes you want to log for this issue. This page also displays how many votes you've given to other bugs, allowing you may reallocate your votes as necessary.</li>

      <li>You receive automatic email notification anytime changes occur on issues you have voted for.</li>

      <li>You may review your votes at any time by clicking the "Change your password or preferences" link in the IssueZilla tool bar or at the bottom of the query page.</li>
     </ul>

     <p>What's the purpose of this voting feature? Read about the important role of <a href="http://www.tigris.org/editorial/safetynet.html">consensus voting in open source projects</a>.</p>
    </dd>

    <dt>Groups</dt>

    <dd>If one or more drop boxes appear identifying project-defined groups to be included in or excluded from viewing an issue, this indicates that the project/component owner has created groups within the project. You should contact this person to determine how to use these fields.</dd>

    <dt>Leave as NEW</dt>

    <dd>If you are viewing an issue with the status NEW but it is not assigned to you, leave this default as checked. When the issue <i>is</i> assigned to you, you should accept it by changing its status to "Started."</dd>

    <dt>Resolve issue</dt>

    <dd>Once an issue is resolved, this is where to designate the type of resolution. Changing an issue to "Resolved" means that as far as the assignee is concerned, this issue is completed. <a href="issue_lifecycle.html#resolvedissues">Read more</a> about the multiple options in this field's pull-down menu. <b>Note: Changing an issue's status to FIXED signals all other project members that any source file changes associated with this issue have been checked into the CVS repository.</b></dd>

    <dt>Reassign</dt>

    <dd>The person responsible for the issue can be changed here by entering a new email address, or reassigned to the component/sub component owner.</dd>

    <dt>View Issue Activity</dt>

    <dd>This link displays a snapshot page of changes made to an issue.</dd>

    <dt>Format For Printing</dt>

    <dd>This links redisplays the Issue View in a format for printing out.</dd>

    <dt>Commit</dt>

    <dd>
     This button saves any modifications made to this issue. <b>Caution! When viewing an issue, the "Enter" key works like the <i>Commit</i> button. Any modifications you may have made (accidentally or otherwise) are saved and the issue's assignee and cc list receive email notification of activity on this issue.</b> 

     <p><em>To exit out of viewing this issue without making any changes</em>, use the links at the top of this page or in the IssueZilla tool bar to view other issues, or the <i>Back</i> button in your browser. Even when you have changed fields, as long as you do not use the <i>Commit</i> button or the "Enter" key, the issue remains unchanged in the database.</p>
    </dd>

    <dt>Reset</dt>

    <dd>Returns all fields to their <i>previously committed</i> values.</dd>
   </dl>

   <div class="courtesylinks">
    <p><a href="ProjectIssues.html">Back to Project Issues help</a><br />
    <a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>
  </div>
 


@


1.5
log
@extensive markup rework - first pass toward house xhtmlification
@
text
@d1 2
a2 13
<!DOCTYPE html PUBLIC "-//CollabNet//DTD XHTML 1.0 Transitional//EN"
"http://collabnet.com/dtds/collabnet_transitional_10.dtd">
<html>
 <head>
  <title>Entering and Modifying Issues</title>
<style type="text/css">
 div.c1 {margin-left: 2em}
</style>
 </head>

 <body>
  <div class="docs" id="docid">
<h2>Entering and modifying issues</h2>
d4 2
a5 1
  <p><strong>More help on IssueZilla: Index</strong></p>
d7 3
a9 3
  <div>
   <dl>
    <dt><a href="ProjectIssues.html">Project issue tracking</a></dt>
d11 3
a13 2
    <dd>
     <strong>You are here: Entering and modifying issues</strong> 
d15 2
a16 2
     <ul>
      <li><strong><a href="#enterissue">Entering a new issue</a></strong></li>
d18 1
a18 1
      <li><strong><a href="#entryfields">Issue entry field descriptions</a></strong></li>
d20 3
a22 3
      <li><strong><a href="#editissue">Viewing and modifying issues</a></strong></li>
     </ul>
    </dd>
d24 1
a24 1
    <dd><a href="ddIssues_Query.html">Querying and tracking issues</a></dd>
d26 4
a29 1
    <dd><a href="ddIssues_Reports.html">Generating status reports about project issues</a></dd>
d31 1
a31 3
    <dt><a href="/servlets/HelpTOC">Back to main Help index</a></dt>
   </dl>
  </div>
d33 2
a34 1
  <p><strong>More help about issues</strong></p>
d36 1
a36 4
  <div>
   <dl>
    <dt><a href="issuewritinghelp.html">Issue writing guidelines</a><br />
    </dt>
d38 1
a38 1
    <dt><a href="contributing_patches.html">Contributing patches</a></dt>
d40 3
a42 2
    <dt><a href="issue_lifecycle.html">The lifecycle of an issue</a><br />
    </dt>
d44 3
a46 3
    <dt><a href="issues_unconfirmedhelp.html">Understanding the UNCONFIRMED issue state</a></dt>
   </dl>
  </div>
d48 1
a48 1
  <h3><a id="enterissue" name="enterissue">Entering a new issue</a></h3>
d50 2
a51 2
  <ul>
   <li>Choose the appropriate link in the "Enter An Issue" section of the Project Issues page. Once you have invoked IssueZilla, a secondary "Issue Tracking" tool bar appears on this page and you can also enter an issue by clicking the <i>New</i> link in the IssueZilla tool bar.</li>
d53 1
a53 1
   <li>Choose the appropriate project component.</li>
d55 2
a56 2
   <li>Selected the appropriate options or input information for each field before using the <i>Commit</i> button to enter your issue.</li>
  </ul>
d58 1
a58 1
  <p>The information you provide here significantly determines the effectiveness of your issue reports and the response to them. Descriptions for each of these fields follow to help you optimize your issue reports.</p>
d60 1
a60 1
  <p><b>Important note</b>: When you first enter a new issue, you cannot set a target milestone date, nor can you assign dependencies (flag other issues that depend on this new issue or those that it depends upon). To designate a target milestone or dependencies, you must first submit the new issue successfully, then retrieve it to access fields for setting a target milestone and creating dependencies.</p>
d62 1
a62 1
  <h3><a id="entryfields" name="entryfields">Issue entry field descriptions</a></h3>   
d64 2
a65 4
  <dl>
   <dd>
    <h3>Version</h3>
   </dd>
d67 1
a67 1
   <dd>The release in which you identified this issue or found the defect.</dd>
d69 1
a69 3
   <dd>
    <h3>Component/Sub Component</h3>
   </dd>
d71 1
a71 1
   <dd>Identify area within the project that this issue is associated with. Only one selection is permitted.</dd>
d73 1
a73 3
   <dd>
    <h3>Platform</h3>
   </dd>
d75 2
a76 2
   <dd>
    This corresponds to <i>your</i> hardware platform when you are reporting a defect. Options include: 
d78 2
a79 2
    <ul>
     <li>All (happens on all platform; cross-platform issue)</li>
d81 1
a81 1
     <li>Macintosh</li>
d83 1
a83 1
     <li>PC</li>
d85 1
a85 1
     <li>Sun</li>
d87 4
a90 4
     <li>HP</li>
    </ul>
    <b>Note:</b> Selecting the option "All" does not select issues assigned against all platforms. It merely selects issues that <i>occur</i> on all platforms.
   </dd>
d92 1
a92 3
   <dd>
    <h3>Operating System</h3>
   </dd>
d94 2
a95 2
   <dd>
    This is the operating system against which the issue is being reported. Legal operating systems include: 
d97 2
a98 2
    <ul>
     <li>All (happens on all operating systems, making this a cross-platform issue)</li>
d100 1
a100 1
     <li>Windows 95</li>
d102 1
a102 1
     <li>Mac System 8.0</li>
d104 4
a107 4
     <li>Linux</li>
    </ul>
    Note that the operating system implies the platform, but not always. For example, Linux can run on PC, Macintosh, and others.
   </dd>
d109 1
a109 3
   <dd>
    <h3>Priority</h3>
   </dd>
d111 2
a112 2
   <dd>
    This field let you assign a level of importance to help determine when this issue should be addressed relative to other issues. This field is utilized by the programmers/engineers to prioritize their work. 
d114 2
a115 3
    <table>
     <tr>
      <th>P1</th>
d117 1
a117 2
      <td>Most important</td>
     </tr>
d119 1
a119 2
     <tr>
      <th>P2</th>
d121 1
a121 3
      <td>
      </td>
     </tr>
d123 3
a125 2
     <tr>
      <th>P3</th>
d127 1
a127 3
      <td>
      </td>
     </tr>
d129 2
a130 2
     <tr>
      <th>P4</th>
d132 1
a132 3
      <td>
      </td>
     </tr>
d134 1
a134 2
     <tr>
      <th>P5</th>
d136 1
a136 4
      <td>Least important</td>
     </tr>
    </table>
   </dd>
d138 2
a139 3
   <dd>
    <h3>Issue Type</h3>
   </dd>
d141 1
a141 3
   <dd>
    <blockquote>
     <p><b><i>Defect</i></b> is a problem with an existing feature that is either not developed to spec or does not work as designed. These are often referred to as "bugs."</p>
d143 1
a143 1
     <p><b><i>Enhancement</i></b> is an improvement to an existing feature.</p>
d145 1
a145 1
     <p><b><i>Feature</i></b> is an addition to the software to add a piece of functionality that does not yet exist.</p>
d147 1
a147 1
     <p><b><i>Task</i></b> is an activity to be done on behalf or in support of a feature or enhancement. Tasks do not typically require direct changes to the code base.</p>
d149 1
a149 3
     <p><b><i>Patch</i></b> is a special kind of issue, a section of code to be applied or attached to existing software, often to fix a defect.</p>
    </blockquote>
   </dd>
d151 2
a152 3
   <dd>
    <h3>Initial state</h3>
   </dd>
d154 2
a155 1
   <dd>Newly entered issues are either "new" or "unconfirmed." Marking an issue <a href="/docs/issues_unconfirmedhelp.html">unconfirmed</a> means you have not yet determined whether it is true or valid. Read more about "state" in the <a href="issue_lifecycle.html">lifecycle of an issue</a>.</dd>
d157 1
a157 3
   <dd>
    <h3>Assigned To</h3>
   </dd>
d159 2
a160 1
   <dd>Enter the email address of the one individual who is in charge of resolving the issue. If this field is left blank, the issue by default is assigned to the component/sub component owner. Every time this field changes, the status changes to <b>NEW</b> to make it visible in the assignee's list of issues.</dd>
d162 2
a163 2
   <dt><br />
   </dt>
d165 1
a165 3
   <dd>
    <h3>Cc:</h3>
   </dd>
d167 1
a167 2
   <dd>
    Add email addresses of other individuals who need email notification when this issue changes status or when there is other activity on this issue. Delimit multiple email addressees by single spaces only -- no commas or semi-colons are necessary. 
d169 3
a171 2
    <p>Note: Assign cc addresses sparingly. Project participants whose interest or involvement in this issue is peripheral should be encouraged to use IssueZilla to check and track issues rather than to rely on automatic email notification.</p>
   </dd>
d173 1
a173 3
   <dd>
    <h3>URL</h3>
   </dd>
d175 1
a175 2
   <dd>
    How to use this field depends on the issue type: 
d177 1
a177 2
    <ul>
     <li>For defects, URL should lead to a fairly stable system where the the problem is obvious or can be easily reproduced.</li>
d179 2
a180 1
     <li>For enhancements, URL should provide details pertaining to the improvement, such as mockups.</li>
d182 1
a182 1
     <li>For features, URL should link to any web-based form of material explaining the improvement such as mockups or design specs.</li>
d184 1
a184 3
     <li>For tasks, URL is optional and may include linking to the associated feature or enhancement.</li>
    </ul>
   </dd>
d186 1
a186 3
   <dd>
    <h3>Summary</h3>
   </dd>
d188 1
a188 1
   <dd>A terse, specific statement to describe this issue. This should a few unique, self-explanatory words to identify this issue easily in reports and short lists. Limiting your entry to the width of the field is best for the columnar display of query results.</dd>
d190 1
a190 3
   <dd>
    <h3>Description</h3>
   </dd>
d192 1
a192 2
   <dd>Provide a full description of the issue including any pertinent history or activity around this issue. Because this field is additive, it serves as the knowledge base and means of communicating through this issue's life cycle. Other project participants view and add comments or information using this field.</dd>
  </dl>
d194 1
a194 1
  <h3>After completing all necessary fields:</h3>
d196 2
a197 4
  <blockquote>
   <p>
<i>Commit</i> enters this issue into the project's issue database. 
</p>
d199 2
d202 1
a202 1
   <p><i>Reset</i> returns all field values to their default or blank settings.</p>
d204 2
a205 2
   <p><i>Remember values as bookmark template</i> lets you save your input settings to save keystrokes when entering multiple issues for the same project component.</p>
  </blockquote>
d207 1
a207 1
  <p>For more information about entering issues into IssueZilla, see also <a href="issuewritinghelp.html">Issue Writing Guidelines</a>.</p>
d209 1
a209 1
  <h3>Viewing and modifying issues</h3>
d211 1
a211 1
  <p>Existing issues may be accessed in two different ways:</p>
d213 1
a213 2
  <ul>
   <li>Entering a specific issue number in the "Find" field located in the IssueZilla tool bar displays the "Issue View" page.</li>
d215 1
a215 2
   <li>Querying for issues either by clicking the "Query database" button in the Project Issues page, or by clicking the "Query" link in the IssueZilla tool bar displays an "Issue List" page of your results. (See <a href="ddIssues_Query.html">Querying and tracking issues</a>.)</li>
  </ul>
d217 1
a217 1
  <p>The Issue View page is similar to the Issue Entry page and contains many of the same fields, but there are several important additions:</p>
d219 1
a219 4
  <dl>
   <dd>
    <h3>Target Milestone</h3>
   </dd>
d221 1
a221 1
   <dd>If your project has designated milestones, this field can be used to associated issues with those milestones, such as version releases. A milestone plan enumerates when different features are expected to be completed. If an issue has a target date or version release, this means the work on this issue must be completed by that date. This field should only be set or changed by the person responsible for the issue.</dd>
d223 1
a223 3
   <dd>
    <h3>Add/Remove CC:</h3>
   </dd>
d225 1
a225 1
   <dd>You can add additional email addresses to this issue to alert other project members when activity occurs on this issue. If you are adding multiple addresses, delimit these with single spaces; do not use commas or semi-colons. You can also <i>remove</i> one or more email address listed by selecting it and checking the "Remove selected Cc's" box below.</dd>
d227 2
a228 3
   <dd>
    <h3>QA Contact</h3>
   </dd>
d230 1
a230 1
   <dd>This field should contain an email address or alias for the person(s) responsible for quality control of this issue.</dd>
d232 2
a233 3
   <dd>
    <h3>URL</h3>
   </dd>
d235 1
a235 1
   <dd>If this field is populated, clicking the field label links directly to the designated URL.</dd>
d237 1
a237 3
   <dd>
    <h3>Status Whiteboard</h3>
   </dd>
d239 1
a239 1
   <dd>The purpose of this generic field can be user-defined and project-specific. (In BugZilla, this field is used for writing short, one-line notes about the bug.)</dd>
d241 3
a243 3
   <dd>
    <h3>Attachments</h3>
   </dd>
d245 1
a245 2
   <dd>
    Adding attachment to an issue can be very useful. For defects, appending test cases, screen shots and/or editor logs to the issue can help pinpoint the problem to help the developer reproduce it. 
d247 1
a247 1
    <p>For features, enhancements, and tasks, you can attach screen shots, mockups, and other files to provide supplemental information to illustrate the issue.</p>
d249 1
a249 2
    <p>You can also used this field to attach a patch related to the issue when appropriate. Read more about <a href="contributing_patches.html">contributing patches</a>.</p>
   </dd>
d251 1
a251 3
   <dd>
    <h3>Dependencies</h3>
   </dd>
d253 2
a254 1
   <dd>When an issue can't be addressed until one or more other issues are resolved, these are dependencies. Each issue can have other issues it depends upon , as well as issues that depend upon it, that is, other issues that this issue "blocks" while being unresolved. The links next to these fields display a tree and graph illustrating the dependencies associated with the issue currently being viewed.</dd>
d256 1
a256 3
   <dd>
    <h3>Vote for this issue</h3>
   </dd>
d258 1
a258 3
   <dd>
    <!-- (adapted from bugzilla.mozilla.org's "Bugzilla Voting" page) -->
    IssueZilla's "voting" feature allows project members to have a certain number of votes in their project to use toward issues. Project owners set the number of votes allowed per issue, as well as the number of votes allowed per member. Some projects/components may not allow any, which means you can't vote on those issues at all. Your vote indicates which issues you believe are the most important to be addressed. 
d260 1
a260 1
    <p>You may vote for the same bug more than once, however, you have a limited number of total votes allocated to you. You can either vote once for many issues, or use multiple votes for a fewer issues that you think are particularly critical.</p>
d262 2
a263 1
    <p>If an issue has received votes, the total number appears next to "Votes for this issue", or "0" if no votes have been logged. Clicking on this number displays the Show Votes page. If there are votes, names and their associated number of votes are listed.</p>
d265 2
a266 1
    <p>To view a list of issues that have received votes, use the IssueZilla Query page, and enter the numeral "1" in the "At least ___ votes" field. This returns issues in your query results with at least one vote.</p>
d268 1
a268 1
    <p>To vote for an issue:</p>
d270 1
a270 2
    <ul>
     <li>Open the issue (using the "Find" link in the tool bar or by clicking the issue from a list or report).</li>
d272 1
a272 1
     <li>Click on the "Vote for this issue" link just above the "Additional Comments" field. (If no such link appears, then voting may not be allowed for this issue's project/component.)</li>
d274 1
a274 1
     <li>Indicate the number of votes you want to log for this issue. This page also displays how many votes you've given to other bugs, allowing you may reallocate your votes as necessary.</li>
d276 1
a276 1
     <li>You receive automatic email notification anytime changes occur on issues you have voted for.</li>
d278 1
a278 2
     <li>You may review your votes at any time by clicking the "Change your password or preferences" link in the IssueZilla tool bar or at the bottom of the query page.</li>
    </ul>
d280 1
a280 2
    <p>What's the purpose of this voting feature? Read about the important role of <a href="http://www.tigris.org/editorial/safetynet.html">consensus voting in open source projects</a>.</p>
   </dd>
d282 1
a282 3
   <dd>
    <h3>Groups</h3>
   </dd>
d284 1
a284 1
   <dd>If one or more drop boxes appear identifying project-defined groups to be included in or excluded from viewing an issue, this indicates that the project/component owner has created groups within the project. You should contact this person to determine how to use these fields.</dd>
d286 1
a286 3
   <dd>
    <h3>Leave as NEW</h3>
   </dd>
d288 1
a288 1
   <dd>If you are viewing an issue with the status NEW but it is not assigned to you, leave this default as checked. When the issue <i>is</i> assigned to you, you should accept it by changing its status to "Started."</dd>
d290 1
a290 3
   <dd>
    <h3>Resolve issue</h3>
   </dd>
d292 1
a292 1
   <dd>Once an issue is resolved, this is where to designate the type of resolution. Changing an issue to "Resolved" means that as far as the assignee is concerned, this issue is completed. <a href="issue_lifecycle.html#resolvedissues">Read more</a> about the multiple options in this field's pull-down menu. <b>Note: Changing an issue's status to FIXED signals all other project members that any source file changes associated with this issue have been checked into the CVS repository.</b></dd>
d294 2
a295 3
   <dd>
    <h3>Reassign</h3>
   </dd>
d297 2
a298 1
   <dd>The person responsible for the issue can be changed here by entering a new email address, or reassigned to the component/sub component owner.</dd>
d300 1
a300 3
   <dd>
    <h3>View Issue Activity</h3>
   </dd>
d302 2
a303 27
   <dd>This link displays a snapshot page of changes made to an issue.</dd>

   <dd>
    <h3>Format For Printing</h3>
   </dd>

   <dd>This links redisplays the Issue View in a format for printing out.</dd>

   <dd>
    <h3>Commit</h3>
   </dd>

   <dd>
    This button saves any modifications made to this issue. <b>Caution! When viewing an issue, the "Enter" key works like the <i>Commit</i> button. Any modifications you may have made (accidentally or otherwise) are saved and the issue's assignee and cc list receive email notification of activity on this issue.</b> 

    <p><b><i>To exit out of viewing this issue without making any changes</i></b>, use the links at the top of this page or in the IssueZilla tool bar to view other issues, or the <i>Back</i> button in your browser. Even when you have changed fields, as long as you do not use the <i>Commit</i> button or the "Enter" key, the issue remains unchanged in the database.</p>
   </dd>

   <dd>
    <h3>Reset</h3>
   </dd>

   <dd>Returns all fields to their <i>previously committed</i> values.</dd>
  </dl>

  <div class="courtesylinks">
   <a href="ProjectIssues.html">Back to Project Issues help</a><br />
d306 2
a307 1
    <a href="/servlets/HelpTOC">Back to main Help index</a>
d310 1
a310 3
 </div>
</body>
</html>
@


1.4
log
@added index
@
text
@d1 2
d4 16
a19 1
<head>
d21 2
a22 1
<title>Entering and Modifying Issues</title>
d24 2
a25 2
</head>
<body>
d27 1
a27 1
    <span class="Header" nowrap>Entering and modifying issues</span>  
d29 1
a29 40
<p>
<span class="PlainText"><strong>More help on IssueZilla: Index</strong>
<p>

<ul>
<dl>
<dt><a href="ProjectIssues.html">Project issue tracking</a>
	<dd><strong>You are here: Entering and modifying issues</a>
		<ul>
		<li><a href="#enterissue">Entering a new issue</a>
		<li><a href="#entryfields">Issue entry field descriptions</a>
	    <li><a href="#editissue">Viewing and modifying issues</a>
		</ul></strong>
	<dd><a href="ddIssues_Query.html">Querying and tracking issues</a>
	<dd><a href="ddIssues_Reports.html">Generating status reports about project issues</a>
<dt><a href="/servlets/HelpTOC">Back to main Help index</a>
</dl>
</ul>

<span class="PlainText">
	
<p>
<strong>More help about issues</strong>
<ul>
	<dl>	
	 <dt><a href="issuewritinghelp.html">Issue writing guidelines</a><br>
	 <dt><a href="contributing_patches.html">Contributing patches</a>
	 <dt><a href="issue_lifecycle.html">The lifecycle of an issue</a><br>
	 <dt><a href="issues_unconfirmedhelp.html">Understanding the UNCONFIRMED issue state</a>
	</dl> 
</ul>
     <p>
<hr noshade size=1>
<a name="enterissue"></a><span class="InputHeader">Entering a new issue</span>
     <ul>
      <li>Choose the appropriate link in the "Enter An Issue" section of the Project Issues page. Once you have invoked IssueZilla, a secondary "Issue Tracking" tool bar appears on this page and you can also enter an issue by clicking the <i>New</i> link in the IssueZilla tool bar.
<p>
      <li>Choose the appropriate project component.
<p>
      <li>Selected the appropriate options or input information for each field before using the <i>Commit</i> button to enter your issue.
d31 153
a183 93
     <p>
      The information you provide here significantly determines the effectiveness of your issue reports and the response to them. Descriptions for each of these fields follow to help you optimize your issue reports.
<p>
<b>Important note</b>: When you first enter a new issue, you cannot set a target milestone date, nor can you assign dependencies (flag other issues that depend on this new issue or those that it depends upon). To designate a target milestone or dependencies, you must first submit the new issue successfully, then retrieve it to access fields for setting a target milestone and creating dependencies.
<p>

<hr noshade size=1>
<p>
<a name="entryfields"></a><span class="InputHeader">Issue entry field descriptions</span>
     <dl>
      <dt><span class="InputHeader">Version</span>
      <dd>The release in which you identified this issue or found the defect. 
      <p>
      <dt><span class="InputHeader">Component/Sub Component</span>
      <dd>Identify area within the project that this issue is associated with. Only one selection is permitted.
      <p>
      <dt><a name="rep_platform"><span class="InputHeader">Platform</span></a>
      <dd>This corresponds to <i>your</i> hardware platform when you are reporting a defect. Options include:
      <ul>
       <li> All (happens on all platform; cross-platform issue)
       <li> Macintosh
       <li> PC
       <li> Sun
       <li> HP
      </ul>
      <b>Note:</b> Selecting the option "All" does not select issues assigned against all platforms.  It merely selects issues that <i>occur</i> on all platforms.
      <p>
      <dt><a name="op_sys"><span class="InputHeader">Operating System</span></a>
       <dd>This is the operating system against which the issue is being reported. Legal operating systems include:
      <ul>
       <li> All (happens on all operating systems, making this a cross-platform issue)
       <li> Windows 95
       <li> Mac System 8.0
       <li> Linux
      </ul>

       Note that the operating system implies the platform, but not always. For example, Linux can run on PC, Macintosh, and others.
      <p>
      <dt><a name="priority"><span class="InputHeader">Priority</span></a>
       <dd>This field let you assign a level of importance to help determine when this issue should be addressed relative to other issues. This field is utilized by the programmers/engineers to prioritize their work.
      <p>
      <table>
       <tr><th>P1</th><td>Most important
       <tr><th>P2</th><td>
       <tr><th>P3</th><td>
       <tr><th>P4</th><td>
       <tr><th>P5</th><td>Least important
      </table>
      <p>
      <dt><a name="issue_type"><span class="InputHeader">Issue Type</span></a>
      <blockquote>
       <p><b><i>Defect</i></b> is a problem with an existing feature that is either not developed to spec or does not work as designed. These are often referred to as "bugs."
       <p><b><i>Enhancement</i></b> is an improvement to an existing feature.
       <p><b><i>Feature</i></b> is an addition to the software to add a piece of functionality that does not yet exist.
       <p><b><i>Task</i></b> is an activity to be done on behalf or in support of a feature or enhancement. Tasks do not typically require direct changes to the code base.
	   <p><b><i>Patch</i></b> is a special kind of issue, a section of code to be applied or attached to existing software, often to fix a defect.
      </blockquote>
      <p>

      <dt><span class="InputHeader">Initial state</span>
       <dd>Newly entered issues are either "new" or "unconfirmed." Marking an issue <a  href="/docs/issues_unconfirmedhelp.html">unconfirmed</a> means you have not yet determined whether it is true or valid. Read more about "state" in the <a href="issue_lifecycle.html">lifecycle of an issue</a>.


       <p>
       <dt><a name="assigned_to"><span class="InputHeader">Assigned To</span></a>
        <dd>Enter the email address of the one individual who is in charge of resolving the issue. If this field is left blank, the issue by default is assigned to the component/sub component owner. Every time this field changes, the status changes to <b>NEW</b> to make it visible in the assignee's list of issues.
       <dt><p><span class="InputHeader">Cc:</span>
		<dd>Add email addresses of other individuals who need email notification when this issue changes status or when there is other activity on this issue. Delimit multiple email addressees by single spaces only -- no commas or semi-colons are necessary.
       <p>Note: Assign cc addresses sparingly. Project participants whose interest or involvement in this issue is peripheral should be encouraged to use IssueZilla to check and track issues rather than to rely on automatic email notification.

       <p>
       <dt><span class="InputHeader">URL</span>
        <dd>How to use this field depends on the issue type:
       <p>
       <ul>
        <li>For defects, URL should lead to a fairly stable system where the the problem is obvious or can be easily reproduced.
        <li>For enhancements, URL should provide details pertaining to the improvement, such as mockups.
        <li>For features, URL should link to any web-based form of material explaining the improvement such as mockups or design specs.
        <li>For tasks, URL is optional and may include linking to the associated feature or enhancement.
       </ul>
       <p>
       <dt><span class="InputHeader">Summary</span>
        <dd>A terse, specific statement to describe this issue. This should a few unique, self-explanatory words to identify this issue easily in reports and short lists. Limiting your entry to the width of the field is best for the columnar display of query results.
       <p>
       <dt><span class="InputHeader">Description</span>
        <dd>Provide a full description of the issue including any pertinent history or activity around this issue. Because this field is additive, it serves as the knowledge base and means of communicating through this issue's life cycle. Other project participants view and add comments or information using this field.
       <p>
     </dl><span class="InputHeader">After completing all necessary fields: </span>
     <p>
     <blockquote>
      <i>Commit</i> enters this issue into the project's issue database.
      <p><i>Reset</i> returns all field values to their default or blank settings.
      <p><i>Remember values as bookmark template</i> lets you save your input settings to save keystrokes when entering multiple issues for the same project component.
d185 7
d193 3
a195 2
    <p>For more information about entering issues into IssueZilla, see also <a href="issuewritinghelp.html">Issue Writing Guidelines</a>.
<p>
d197 21
a217 2
<hr noshade size=1>
<a name="editissue"><span class="InputHeader">Viewing and modifying issues</span></a>
a218 1
    <p>Existing issues may be accessed in two different ways:
d220 7
a226 2
     <li>Entering a specific issue number in the "Find" field located in the IssueZilla tool bar displays the "Issue View" page. 
     <li>Querying for issues either by clicking the "Query database" button in the Project Issues page, or by clicking the "Query" link in the IssueZilla tool bar displays an "Issue List" page of your results. (See <a href="ddIssues_Query.html">Querying and tracking issues</a>.)
d228 94
d323 3
a325 1
    <p>The Issue View page is similar to the Issue Entry page and contains many of the same fields, but there are several important additions:
d327 1
a327 44
    <p>
    <dl>
     <dt><span class="InputHeader">Target Milestone</span>
      <dd>If your project has designated milestones, this field can be used to associated issues with those milestones, such as version releases. A milestone plan enumerates when different features are expected to be completed. If an issue has a target date or version release, this means the work on this issue must be completed by that date. This field should only be set or changed by the person responsible for the issue. 
     <p>

     <dt><span class="InputHeader">Add/Remove CC:</span>
      <dd>You can add additional email addresses to this issue to alert other project members when activity occurs on this issue. If you are adding multiple addresses, delimit these with single spaces; do not use commas or semi-colons. You can also <i>remove</i> one or more email address listed by selecting it and checking the "Remove selected Cc's" box below.
     <p>
     <dt><span class="InputHeader">QA Contact</span>
      <dd>This field should contain an email address or alias for the person(s) responsible for quality control of this issue.
     <p>

     <dt><span class="InputHeader">URL</span>
      <dd>If this field is populated, clicking the field label links directly to the designated URL.
     <p>

     <dt><span class="InputHeader">Status Whiteboard</span>
      <dd>The purpose of this generic field can be user-defined and project-specific. (In BugZilla, this field is used for writing short, one-line notes about the bug.)
     <p>

     <dt><span class="InputHeader">Attachments</span>
      <dd>Adding attachment to an issue can be very useful. For defects, appending test cases, screen shots and/or editor logs to the issue can help pinpoint the problem to help the developer reproduce it.

     <p> <p>For features, enhancements, and tasks, you can attach screen shots, mockups, and other files to provide supplemental information to illustrate the issue.
	<p>You can also used this field to attach a patch related to the issue when appropriate. Read more about <a href="contributing_patches.html">contributing patches</a>.
    
     <p>
     <dt><span class="InputHeader">Dependencies</span>
      <dd>When an issue can't be addressed until one or more other issues are resolved, these are dependencies. Each issue can have other issues it depends upon , as well as issues that depend upon it, that is, other issues that this issue "blocks" while being unresolved. The links next to these fields display a tree and graph illustrating the dependencies associated with the issue currently being viewed.
     <p>


 	<dt><span class="InputHeader">Vote for this issue</span> 
      <dd>
<!-- (adapted from bugzilla.mozilla.org's "Bugzilla Voting" page) -->

IssueZilla's "voting" feature allows project members to have a certain number of votes in their project to use toward issues. Project owners set the number of votes allowed per issue, as well as the number of votes allowed per member. Some projects/components may not allow any, which means you can't vote on those issues at all. Your vote indicates which issues you believe are the most important to be addressed. 
     <p>
You may vote for the same bug more than once, however, you have a limited number of total votes allocated to you. You can either vote once for many issues, or use multiple votes for a fewer issues that you think are particularly critical.
     <p>
If an issue has received votes, the total number appears next to "Votes for this issue", or "0" if no votes have been logged. Clicking on this number displays the Show Votes page. If there are votes, names and their associated number of votes are listed.
     <p>
To view a list of issues that have received votes, use the IssueZilla Query page, and enter the numeral "1" in the "At least ___ votes" field. This returns issues in your query results with at least one vote.
d329 76
a404 51
     <p>To vote for an issue: 
     <ul>
      <li>Open the issue (using the "Find" link in the tool bar or by clicking the issue from a list or report).
      <li>Click on the "Vote for this issue" link just above the "Additional Comments" field. (If no such link appears, then voting may not be allowed for this issue's project/component.) 
      <li>Indicate the number of votes you want to log for this issue. This page also displays how many votes you've given to other bugs, allowing you may reallocate your votes as necessary.
      <li>You receive automatic email notification anytime changes occur on issues you have voted for. 
      <li>You may review your votes at any time by clicking the "Change your password or preferences" link in the IssueZilla tool bar or at the bottom of the query page.
     </ul>
     <p>
What's the purpose of this voting feature? Read about the important role of <a href="http://www.tigris.org/editorial/safetynet.html" target="_new">consensus voting in open source projects</a>.
     <p>

     <dt><span class="InputHeader">Groups</span>
      <dd>If one or more drop boxes appear identifying project-defined groups to be included in or excluded from viewing an issue, this indicates that the project/component owner has created groups within the project. You should contact this person to determine how to use these fields.
     <p>

     <dt><span class="InputHeader">Leave as NEW</span>
      <dd>If you are viewing an issue with the status NEW but it is not assigned to you, leave this default as checked. When the issue <i>is</i> assigned to you, you should accept it by changing its status to "Started."
     <p>

     <dt><span class="InputHeader">Resolve issue</span> 
      <dd>Once an issue is resolved, this is where to designate the type of resolution. Changing an issue to "Resolved" means that as far as the assignee is concerned, this issue is completed. <a href="issue_lifecycle.html#resolvedissues">Read more</a> about the multiple options in this field's pull-down menu. <b>Note: Changing an issue's status to FIXED signals all other project members that any source file changes associated with this issue have been checked into the CVS repository.</b>
     <p>

     <dt><span class="InputHeader">Reassign</span>
      <dd>The person responsible for the issue can be changed here by entering a new email address, or reassigned to the component/sub component owner. 
     <p>

     <dt><span class="InputHeader">View Issue Activity</span>
      <dd>This link displays a snapshot page of changes made to an issue.
     <p>

     <dt><span class="InputHeader">Format For Printing</span>
      <dd>This links redisplays the Issue View in a format for printing out. 

     <p>
     <dt><span class="InputHeader">Commit</span>
      <dd>This button saves any modifications made to this issue. <b>Caution! When viewing an issue, the "Enter" key works like the <i>Commit</i> button. Any modifications you may have made (accidentally or otherwise) are saved and the issue's assignee and cc list receive email notification of activity on this issue.</b>

     <p><b><i>To exit out of viewing this issue without making any changes</i></b>, use the links at the top of this page or in the IssueZilla tool bar to view other issues, or the <i>Back</i> button in your browser. Even when you have changed fields, as long as you do not use the <i>Commit</i> button or the "Enter" key, the issue remains unchanged in the database.
     <p>

     <dt><span class="InputHeader">Reset</span>
      <dd>Returns all fields to their <i>previously committed</i> values.
    </dl>
<p>

<hr noshade size=1>
<a href="ProjectIssues.html">Back to Project Issues help</a><br>
<a href="/servlets/HelpTOC">Back to main Help index</a></p></span>
</span>
d406 5
d413 2
@


1.3
log
@added <title> tags to all files
@
text
@d1 2
a2 2
<HTML>
<HEAD>
d4 1
a4 1
<TITLE>Entering and Modifying Issues</TITLE>
d6 47
a52 35
</HEAD>
<BODY>
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
    <SPAN CLASS="Header" NOWRAP>Entering and modifying issues</SPAN>  

<P>
<SPAN CLASS="PlainText">Contents of this document
<UL>
	<DL>
     <DT><A HREF="#enterissue">Entering a new issue</A></DT>
	 <DT><A HREF="#entryfields">Issue entry field descriptions</A>
     <DT><A HREF="#editissue">Viewing and modifying issues</A></DT>
	</DL>
</UL>
More help about issues
<UL>
	<DL>	
	 <DT><A HREF="issuewritinghelp.html">Issue writing guidelines</A><BR>
	 <DT><A HREF="contributing_patches.html">Contributing patches</A>
	 <DT><A HREF="issue_lifecycle.html">The lifecycle of an issue</A><BR>
	 <DT><A HREF="issues_unconfirmedhelp.html">Understanding the UNCONFIRMED issue state</A>
	</DL> 
</UL>
     <P>
<HR NOSHADE SIZE=1>
<A NAME="enterissue"></A><SPAN CLASS="InputHeader">Entering a new issue</SPAN>
     <UL>
      <LI>Choose the appropriate link in the "Enter An Issue" section of the Project Issues page. Once you have invoked IssueZilla, a secondary "Issue Tracking" tool bar appears on this page and you can also enter an issue by clicking the <I>New</I> link in the IssueZilla tool bar.
<P>
      <LI>Choose the appropriate project component.
<P>
      <LI>Selected the appropriate options or input information for each field before using the <I>Commit</I> button to enter your issue.
     </UL>
     <P>
d54 33
a86 33
<P>
<B>Important note</B>: When you first enter a new issue, you cannot set a target milestone date, nor can you assign dependencies (flag other issues that depend on this new issue or those that it depends upon). To designate a target milestone or dependencies, you must first submit the new issue successfully, then retrieve it to access fields for setting a target milestone and creating dependencies.
<P>

<HR NOSHADE SIZE=1>
<P>
<A NAME="entryfields"></A><SPAN CLASS="InputHeader">Issue entry field descriptions</SPAN>
     <DL>
      <DT><SPAN CLASS="InputHeader">Version</SPAN>
      <DD>The release in which you identified this issue or found the defect. 
      <P>
      <DT><SPAN CLASS="InputHeader">Component/Sub Component</SPAN>
      <DD>Identify area within the project that this issue is associated with. Only one selection is permitted.
      <P>
      <DT><A NAME="rep_platform"><SPAN CLASS="InputHeader">Platform</SPAN></A>
      <DD>This corresponds to <I>your</I> hardware platform when you are reporting a defect. Options include:
      <UL>
       <LI> All (happens on all platform; cross-platform issue)
       <LI> Macintosh
       <LI> PC
       <LI> Sun
       <LI> HP
      </UL>
      <B>Note:</B> Selecting the option "All" does not select issues assigned against all platforms.  It merely selects issues that <I>occur</I> on all platforms.
      <P>
      <DT><A NAME="op_sys"><SPAN CLASS="InputHeader">Operating System</SPAN></A>
       <DD>This is the operating system against which the issue is being reported. Legal operating systems include:
      <UL>
       <LI> All (happens on all operating systems, making this a cross-platform issue)
       <LI> Windows 95
       <LI> Mac System 8.0
       <LI> Linux
      </UL>
d89 92
a180 92
      <P>
      <DT><A NAME="priority"><SPAN CLASS="InputHeader">Priority</SPAN></A>
       <DD>This field let you assign a level of importance to help determine when this issue should be addressed relative to other issues. This field is utilized by the programmers/engineers to prioritize their work.
      <P>
      <TABLE>
       <TR><TH>P1</TH><TD>Most important
       <TR><TH>P2</TH><TD>
       <TR><TH>P3</TH><TD>
       <TR><TH>P4</TH><TD>
       <TR><TH>P5</TH><TD>Least important
      </TABLE>
      <P>
      <DT><A NAME="issue_type"><SPAN CLASS="InputHeader">Issue Type</SPAN></A>
      <BLOCKQUOTE>
       <P><B><I>Defect</I></B> is a problem with an existing feature that is either not developed to spec or does not work as designed. These are often referred to as "bugs."
       <P><B><I>Enhancement</I></B> is an improvement to an existing feature.
       <P><B><I>Feature</I></B> is an addition to the software to add a piece of functionality that does not yet exist.
       <P><B><I>Task</I></B> is an activity to be done on behalf or in support of a feature or enhancement. Tasks do not typically require direct changes to the code base.
	   <P><B><I>Patch</I></B> is a special kind of issue, a section of code to be applied or attached to existing software, often to fix a defect.
      </BLOCKQUOTE>
      <P>

      <DT><SPAN CLASS="InputHeader">Initial state</SPAN>
       <DD>Newly entered issues are either "new" or "unconfirmed." Marking an issue <A  HREF="/docs/issues_unconfirmedhelp.html">unconfirmed</A> means you have not yet determined whether it is true or valid. Read more about "state" in the <A HREF="issue_lifecycle.html">lifecycle of an issue</A>.


       <P>
       <DT><A NAME="assigned_to"><SPAN CLASS="InputHeader">Assigned To</SPAN></A>
        <DD>Enter the email address of the one individual who is in charge of resolving the issue. If this field is left blank, the issue by default is assigned to the component/sub component owner. Every time this field changes, the status changes to <B>NEW</B> to make it visible in the assignee's list of issues.
       <DT><P><SPAN CLASS="InputHeader">Cc:</SPAN>
		<DD>Add email addresses of other individuals who need email notification when this issue changes status or when there is other activity on this issue. Delimit multiple email addressees by single spaces only -- no commas or semi-colons are necessary.
       <P>Note: Assign cc addresses sparingly. Project participants whose interest or involvement in this issue is peripheral should be encouraged to use IssueZilla to check and track issues rather than to rely on automatic email notification.

       <P>
       <DT><SPAN CLASS="InputHeader">URL</SPAN>
        <DD>How to use this field depends on the issue type:
       <P>
       <UL>
        <LI>For defects, URL should lead to a fairly stable system where the the problem is obvious or can be easily reproduced.
        <LI>For enhancements, URL should provide details pertaining to the improvement, such as mockups.
        <LI>For features, URL should link to any web-based form of material explaining the improvement such as mockups or design specs.
        <LI>For tasks, URL is optional and may include linking to the associated feature or enhancement.
       </UL>
       <P>
       <DT><SPAN CLASS="InputHeader">Summary</SPAN>
        <DD>A terse, specific statement to describe this issue. This should a few unique, self-explanatory words to identify this issue easily in reports and short lists. Limiting your entry to the width of the field is best for the columnar display of query results.
       <P>
       <DT><SPAN CLASS="InputHeader">Description</SPAN>
        <DD>Provide a full description of the issue including any pertinent history or activity around this issue. Because this field is additive, it serves as the knowledge base and means of communicating through this issue's life cycle. Other project participants view and add comments or information using this field.
       <P>
     </DL><SPAN CLASS="InputHeader">After completing all necessary fields: </SPAN>
     <P>
     <BLOCKQUOTE>
      <I>Commit</I> enters this issue into the project's issue database.
      <P><I>Reset</I> returns all field values to their default or blank settings.
      <P><I>Remember values as bookmark template</I> lets you save your input settings to save keystrokes when entering multiple issues for the same project component.
    </BLOCKQUOTE>

    <P>For more information about entering issues into IssueZilla, see also <A HREF="issuewritinghelp.html">Issue Writing Guidelines</A>.
<P>

<HR NOSHADE SIZE=1>
<A NAME="editissue"><SPAN CLASS="InputHeader">Viewing and modifying issues</SPAN></A>

    <P>Existing issues may be accessed in two different ways:
    <UL>
     <LI>Entering a specific issue number in the "Find" field located in the IssueZilla tool bar displays the "Issue View" page. 
     <LI>Querying for issues either by clicking the "Query database" button in the Project Issues page, or by clicking the "Query" link in the IssueZilla tool bar displays an "Issue List" page of your results. (See <A HREF="ddIssues_Query.html">Querying and tracking issues</A>.)
    </UL>

    <P>The Issue View page is similar to the Issue Entry page and contains many of the same fields, but there are several important additions:

    <P>
    <DL>
     <DT><SPAN CLASS="InputHeader">Target Milestone</SPAN>
      <DD>If your project has designated milestones, this field can be used to associated issues with those milestones, such as version releases. A milestone plan enumerates when different features are expected to be completed. If an issue has a target date or version release, this means the work on this issue must be completed by that date. This field should only be set or changed by the person responsible for the issue. 
     <P>

     <DT><SPAN CLASS="InputHeader">Add/Remove CC:</SPAN>
      <DD>You can add additional email addresses to this issue to alert other project members when activity occurs on this issue. If you are adding multiple addresses, delimit these with single spaces; do not use commas or semi-colons. You can also <I>remove</I> one or more email address listed by selecting it and checking the "Remove selected Cc's" box below.
     <P>
     <DT><SPAN CLASS="InputHeader">QA Contact</SPAN>
      <DD>This field should contain an email address or alias for the person(s) responsible for quality control of this issue.
     <P>

     <DT><SPAN CLASS="InputHeader">URL</SPAN>
      <DD>If this field is populated, clicking the field label links directly to the designated URL.
     <P>

     <DT><SPAN CLASS="InputHeader">Status Whiteboard</SPAN>
      <DD>The purpose of this generic field can be user-defined and project-specific. (In BugZilla, this field is used for writing short, one-line notes about the bug.)
     <P>
d182 2
a183 2
     <DT><SPAN CLASS="InputHeader">Attachments</SPAN>
      <DD>Adding attachment to an issue can be very useful. For defects, appending test cases, screen shots and/or editor logs to the issue can help pinpoint the problem to help the developer reproduce it.
d185 2
a186 2
     <P> <P>For features, enhancements, and tasks, you can attach screen shots, mockups, and other files to provide supplemental information to illustrate the issue.
	<P>You can also used this field to attach a patch related to the issue when appropriate. Read more about <A HREF="contributing_patches.html">contributing patches</A>.
d188 4
a191 4
     <P>
     <DT><SPAN CLASS="InputHeader">Dependencies</SPAN>
      <DD>When an issue can't be addressed until one or more other issues are resolved, these are dependencies. Each issue can have other issues it depends upon , as well as issues that depend upon it, that is, other issues that this issue "blocks" while being unresolved. The links next to these fields display a tree and graph illustrating the dependencies associated with the issue currently being viewed.
     <P>
d194 2
a195 2
 	<DT><SPAN CLASS="InputHeader">Vote for this issue</SPAN> 
      <DD>
d199 1
a199 1
     <P>
d201 1
a201 1
     <P>
d203 1
a203 1
     <P>
d206 54
a259 54
     <P>To vote for an issue: 
     <UL>
      <LI>Open the issue (using the "Find" link in the tool bar or by clicking the issue from a list or report).
      <LI>Click on the "Vote for this issue" link just above the "Additional Comments" field. (If no such link appears, then voting may not be allowed for this issue's project/component.) 
      <LI>Indicate the number of votes you want to log for this issue. This page also displays how many votes you've given to other bugs, allowing you may reallocate your votes as necessary.
      <LI>You receive automatic email notification anytime changes occur on issues you have voted for. 
      <LI>You may review your votes at any time by clicking the "Change your password or preferences" link in the IssueZilla tool bar or at the bottom of the query page.
     </UL>
     <P>
What's the purpose of this voting feature? Read about the important role of <A HREF="http://www.tigris.org/editorial/safetynet.html" TARGET="_new">consensus voting in open source projects</A>.
     <P>

     <DT><SPAN CLASS="InputHeader">Groups</SPAN>
      <DD>If one or more drop boxes appear identifying project-defined groups to be included in or excluded from viewing an issue, this indicates that the project/component owner has created groups within the project. You should contact this person to determine how to use these fields.
     <P>

     <DT><SPAN CLASS="InputHeader">Leave as NEW</SPAN>
      <DD>If you are viewing an issue with the status NEW but it is not assigned to you, leave this default as checked. When the issue <I>is</I> assigned to you, you should accept it by changing its status to "Started."
     <P>

     <DT><SPAN CLASS="InputHeader">Resolve issue</SPAN> 
      <DD>Once an issue is resolved, this is where to designate the type of resolution. Changing an issue to "Resolved" means that as far as the assignee is concerned, this issue is completed. <A HREF="issue_lifecycle.html#resolvedissues">Read more</A> about the multiple options in this field's pull-down menu. <B>Note: Changing an issue's status to FIXED signals all other project members that any source file changes associated with this issue have been checked into the CVS repository.</B>
     <P>

     <DT><SPAN CLASS="InputHeader">Reassign</SPAN>
      <DD>The person responsible for the issue can be changed here by entering a new email address, or reassigned to the component/sub component owner. 
     <P>

     <DT><SPAN CLASS="InputHeader">View Issue Activity</SPAN>
      <DD>This link displays a snapshot page of changes made to an issue.
     <P>

     <DT><SPAN CLASS="InputHeader">Format For Printing</SPAN>
      <DD>This links redisplays the Issue View in a format for printing out. 

     <P>
     <DT><SPAN CLASS="InputHeader">Commit</SPAN>
      <DD>This button saves any modifications made to this issue. <B>Caution! When viewing an issue, the "Enter" key works like the <I>Commit</I> button. Any modifications you may have made (accidentally or otherwise) are saved and the issue's assignee and cc list receive email notification of activity on this issue.</B>

     <P><B><I>To exit out of viewing this issue without making any changes</I></B>, use the links at the top of this page or in the IssueZilla tool bar to view other issues, or the <I>Back</I> button in your browser. Even when you have changed fields, as long as you do not use the <I>Commit</I> button or the "Enter" key, the issue remains unchanged in the database.
     <P>

     <DT><SPAN CLASS="InputHeader">Reset</SPAN>
      <DD>Returns all fields to their <I>previously committed</I> values.
    </DL>
<P>

<HR NOSHADE SIZE=1>
<A HREF="Help.html">Back to main Help index</A></P></SPAN>
</SPAN>
</TR>
</TABLE>
</BODY>
</HTML>
@


1.2
log
@removed window's nasty line breaks, and corrected more links in HelpBox files
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d1 7
d246 2
@


1.1
log
@new and revised help documentation for v1.0
@
text
@d1 238
a238 238
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
    <SPAN CLASS="Header" NOWRAP>Entering and modifying issues</SPAN>  

<P>
<SPAN CLASS="PlainText">Contents of this document
<UL>
	<DL>
     <DT><A HREF="#enterissue">Entering a new issue</A></DT>
	 <DT><A HREF="#entryfields">Issue entry field descriptions</A>
     <DT><A HREF="#editissue">Viewing and modifying issues</A></DT>
	</DL>
</UL>
More help about issues
<UL>
	<DL>	
	 <DT><A HREF="issuewritinghelp.html">Issue writing guidelines</A><BR>
	 <DT><A HREF="contributing_patches.html">Contributing patches</A>
	 <DT><A HREF="issue_lifecycle.html">The lifecycle of an issue</A><BR>
	 <DT><A HREF="issues_unconfirmedhelp.html">Understanding the UNCONFIRMED issue state</A>
	</DL> 
</UL>
     <P>
<HR NOSHADE SIZE=1>
<A NAME="enterissue"></A><SPAN CLASS="InputHeader">Entering a new issue</SPAN>
     <UL>
      <LI>Choose the appropriate link in the "Enter An Issue" section of the Project Issues page. Once you have invoked IssueZilla, a secondary "Issue Tracking" tool bar appears on this page and you can also enter an issue by clicking the <I>New</I> link in the IssueZilla tool bar.
<P>
      <LI>Choose the appropriate project component.
<P>
      <LI>Selected the appropriate options or input information for each field before using the <I>Commit</I> button to enter your issue.
     </UL>
     <P>
      The information you provide here significantly determines the effectiveness of your issue reports and the response to them. Descriptions for each of these fields follow to help you optimize your issue reports.
<P>
<B>Important note</B>: When you first enter a new issue, you cannot set a target milestone date, nor can you assign dependencies (flag other issues that depend on this new issue or those that it depends upon). To designate a target milestone or dependencies, you must first submit the new issue successfully, then retrieve it to access fields for setting a target milestone and creating dependencies.
<P>

<HR NOSHADE SIZE=1>
<P>
<A NAME="entryfields"></A><SPAN CLASS="InputHeader">Issue entry field descriptions</SPAN>
     <DL>
      <DT><SPAN CLASS="InputHeader">Version</SPAN>
      <DD>The release in which you identified this issue or found the defect. 
      <P>
      <DT><SPAN CLASS="InputHeader">Component/Sub Component</SPAN>
      <DD>Identify area within the project that this issue is associated with. Only one selection is permitted.
      <P>
      <DT><A NAME="rep_platform"><SPAN CLASS="InputHeader">Platform</SPAN></A>
      <DD>This corresponds to <I>your</I> hardware platform when you are reporting a defect. Options include:
      <UL>
       <LI> All (happens on all platform; cross-platform issue)
       <LI> Macintosh
       <LI> PC
       <LI> Sun
       <LI> HP
      </UL>
      <B>Note:</B> Selecting the option "All" does not select issues assigned against all platforms.  It merely selects issues that <I>occur</I> on all platforms.
      <P>
      <DT><A NAME="op_sys"><SPAN CLASS="InputHeader">Operating System</SPAN></A>
       <DD>This is the operating system against which the issue is being reported. Legal operating systems include:
      <UL>
       <LI> All (happens on all operating systems, making this a cross-platform issue)
       <LI> Windows 95
       <LI> Mac System 8.0
       <LI> Linux
      </UL>

       Note that the operating system implies the platform, but not always. For example, Linux can run on PC, Macintosh, and others.
      <P>
      <DT><A NAME="priority"><SPAN CLASS="InputHeader">Priority</SPAN></A>
       <DD>This field let you assign a level of importance to help determine when this issue should be addressed relative to other issues. This field is utilized by the programmers/engineers to prioritize their work.
      <P>
      <TABLE>
       <TR><TH>P1</TH><TD>Most important
       <TR><TH>P2</TH><TD>
       <TR><TH>P3</TH><TD>
       <TR><TH>P4</TH><TD>
       <TR><TH>P5</TH><TD>Least important
      </TABLE>
      <P>
      <DT><A NAME="issue_type"><SPAN CLASS="InputHeader">Issue Type</SPAN></A>
      <BLOCKQUOTE>
       <P><B><I>Defect</I></B> is a problem with an existing feature that is either not developed to spec or does not work as designed. These are often referred to as "bugs."
       <P><B><I>Enhancement</I></B> is an improvement to an existing feature.
       <P><B><I>Feature</I></B> is an addition to the software to add a piece of functionality that does not yet exist.
       <P><B><I>Task</I></B> is an activity to be done on behalf or in support of a feature or enhancement. Tasks do not typically require direct changes to the code base.
	   <P><B><I>Patch</I></B> is a special kind of issue, a section of code to be applied or attached to existing software, often to fix a defect.
      </BLOCKQUOTE>
      <P>

      <DT><SPAN CLASS="InputHeader">Initial state</SPAN>
       <DD>Newly entered issues are either "new" or "unconfirmed." Marking an issue <A  HREF="/docs/issues_unconfirmedhelp.html">unconfirmed</A> means you have not yet determined whether it is true or valid. Read more about "state" in the <A HREF="issue_lifecycle.html">lifecycle of an issue</A>.


       <P>
       <DT><A NAME="assigned_to"><SPAN CLASS="InputHeader">Assigned To</SPAN></A>
        <DD>Enter the email address of the one individual who is in charge of resolving the issue. If this field is left blank, the issue by default is assigned to the component/sub component owner. Every time this field changes, the status changes to <B>NEW</B> to make it visible in the assignee's list of issues.
       <DT><P><SPAN CLASS="InputHeader">Cc:</SPAN>
		<DD>Add email addresses of other individuals who need email notification when this issue changes status or when there is other activity on this issue. Delimit multiple email addressees by single spaces only -- no commas or semi-colons are necessary.
       <P>Note: Assign cc addresses sparingly. Project participants whose interest or involvement in this issue is peripheral should be encouraged to use IssueZilla to check and track issues rather than to rely on automatic email notification.

       <P>
       <DT><SPAN CLASS="InputHeader">URL</SPAN>
        <DD>How to use this field depends on the issue type:
       <P>
       <UL>
        <LI>For defects, URL should lead to a fairly stable system where the the problem is obvious or can be easily reproduced.
        <LI>For enhancements, URL should provide details pertaining to the improvement, such as mockups.
        <LI>For features, URL should link to any web-based form of material explaining the improvement such as mockups or design specs.
        <LI>For tasks, URL is optional and may include linking to the associated feature or enhancement.
       </UL>
       <P>
       <DT><SPAN CLASS="InputHeader">Summary</SPAN>
        <DD>A terse, specific statement to describe this issue. This should a few unique, self-explanatory words to identify this issue easily in reports and short lists. Limiting your entry to the width of the field is best for the columnar display of query results.
       <P>
       <DT><SPAN CLASS="InputHeader">Description</SPAN>
        <DD>Provide a full description of the issue including any pertinent history or activity around this issue. Because this field is additive, it serves as the knowledge base and means of communicating through this issue's life cycle. Other project participants view and add comments or information using this field.
       <P>
     </DL><SPAN CLASS="InputHeader">After completing all necessary fields: </SPAN>
     <P>
     <BLOCKQUOTE>
      <I>Commit</I> enters this issue into the project's issue database.
      <P><I>Reset</I> returns all field values to their default or blank settings.
      <P><I>Remember values as bookmark template</I> lets you save your input settings to save keystrokes when entering multiple issues for the same project component.
    </BLOCKQUOTE>

    <P>For more information about entering issues into IssueZilla, see also <A HREF="issuewritinghelp.html">Issue Writing Guidelines</A>.
<P>

<HR NOSHADE SIZE=1>
<A NAME="editissue"><SPAN CLASS="InputHeader">Viewing and modifying issues</SPAN></A>

    <P>Existing issues may be accessed in two different ways:
    <UL>
     <LI>Entering a specific issue number in the "Find" field located in the IssueZilla tool bar displays the "Issue View" page. 
     <LI>Querying for issues either by clicking the "Query database" button in the Project Issues page, or by clicking the "Query" link in the IssueZilla tool bar displays an "Issue List" page of your results. (See <A HREF="ddIssues_Query.html">Querying and tracking issues</A>.)
    </UL>

    <P>The Issue View page is similar to the Issue Entry page and contains many of the same fields, but there are several important additions:

    <P>
    <DL>
     <DT><SPAN CLASS="InputHeader">Target Milestone</SPAN>
      <DD>If your project has designated milestones, this field can be used to associated issues with those milestones, such as version releases. A milestone plan enumerates when different features are expected to be completed. If an issue has a target date or version release, this means the work on this issue must be completed by that date. This field should only be set or changed by the person responsible for the issue. 
     <P>

     <DT><SPAN CLASS="InputHeader">Add/Remove CC:</SPAN>
      <DD>You can add additional email addresses to this issue to alert other project members when activity occurs on this issue. If you are adding multiple addresses, delimit these with single spaces; do not use commas or semi-colons. You can also <I>remove</I> one or more email address listed by selecting it and checking the "Remove selected Cc's" box below.
     <P>
     <DT><SPAN CLASS="InputHeader">QA Contact</SPAN>
      <DD>This field should contain an email address or alias for the person(s) responsible for quality control of this issue.
     <P>

     <DT><SPAN CLASS="InputHeader">URL</SPAN>
      <DD>If this field is populated, clicking the field label links directly to the designated URL.
     <P>

     <DT><SPAN CLASS="InputHeader">Status Whiteboard</SPAN>
      <DD>The purpose of this generic field can be user-defined and project-specific. (In BugZilla, this field is used for writing short, one-line notes about the bug.)
     <P>

     <DT><SPAN CLASS="InputHeader">Attachments</SPAN>
      <DD>Adding attachment to an issue can be very useful. For defects, appending test cases, screen shots and/or editor logs to the issue can help pinpoint the problem to help the developer reproduce it.

     <P> <P>For features, enhancements, and tasks, you can attach screen shots, mockups, and other files to provide supplemental information to illustrate the issue.
	<P>You can also used this field to attach a patch related to the issue when appropriate. Read more about <A HREF="contributing_patches.html">contributing patches</A>.
    
     <P>
     <DT><SPAN CLASS="InputHeader">Dependencies</SPAN>
      <DD>When an issue can't be addressed until one or more other issues are resolved, these are dependencies. Each issue can have other issues it depends upon , as well as issues that depend upon it, that is, other issues that this issue "blocks" while being unresolved. The links next to these fields display a tree and graph illustrating the dependencies associated with the issue currently being viewed.
     <P>


 	<DT><SPAN CLASS="InputHeader">Vote for this issue</SPAN> 
      <DD>
<!-- (adapted from bugzilla.mozilla.org's "Bugzilla Voting" page) -->

IssueZilla's "voting" feature allows project members to have a certain number of votes in their project to use toward issues. Project owners set the number of votes allowed per issue, as well as the number of votes allowed per member. Some projects/components may not allow any, which means you can't vote on those issues at all. Your vote indicates which issues you believe are the most important to be addressed. 
     <P>
You may vote for the same bug more than once, however, you have a limited number of total votes allocated to you. You can either vote once for many issues, or use multiple votes for a fewer issues that you think are particularly critical.
     <P>
If an issue has received votes, the total number appears next to "Votes for this issue", or "0" if no votes have been logged. Clicking on this number displays the Show Votes page. If there are votes, names and their associated number of votes are listed.
     <P>
To view a list of issues that have received votes, use the IssueZilla Query page, and enter the numeral "1" in the "At least ___ votes" field. This returns issues in your query results with at least one vote.

     <P>To vote for an issue: 
     <UL>
      <LI>Open the issue (using the "Find" link in the tool bar or by clicking the issue from a list or report).
      <LI>Click on the "Vote for this issue" link just above the "Additional Comments" field. (If no such link appears, then voting may not be allowed for this issue's project/component.) 
      <LI>Indicate the number of votes you want to log for this issue. This page also displays how many votes you've given to other bugs, allowing you may reallocate your votes as necessary.
      <LI>You receive automatic email notification anytime changes occur on issues you have voted for. 
      <LI>You may review your votes at any time by clicking the "Change your password or preferences" link in the IssueZilla tool bar or at the bottom of the query page.
     </UL>
     <P>
What's the purpose of this voting feature? Read about the important role of <A HREF="http://www.tigris.org/editorial/safetynet.html" TARGET="_new">consensus voting in open source projects</A>.
     <P>

     <DT><SPAN CLASS="InputHeader">Groups</SPAN>
      <DD>If one or more drop boxes appear identifying project-defined groups to be included in or excluded from viewing an issue, this indicates that the project/component owner has created groups within the project. You should contact this person to determine how to use these fields.
     <P>

     <DT><SPAN CLASS="InputHeader">Leave as NEW</SPAN>
      <DD>If you are viewing an issue with the status NEW but it is not assigned to you, leave this default as checked. When the issue <I>is</I> assigned to you, you should accept it by changing its status to "Started."
     <P>

     <DT><SPAN CLASS="InputHeader">Resolve issue</SPAN> 
      <DD>Once an issue is resolved, this is where to designate the type of resolution. Changing an issue to "Resolved" means that as far as the assignee is concerned, this issue is completed. <A HREF="issue_lifecycle.html#resolvedissues">Read more</A> about the multiple options in this field's pull-down menu. <B>Note: Changing an issue's status to FIXED signals all other project members that any source file changes associated with this issue have been checked into the CVS repository.</B>
     <P>

     <DT><SPAN CLASS="InputHeader">Reassign</SPAN>
      <DD>The person responsible for the issue can be changed here by entering a new email address, or reassigned to the component/sub component owner. 
     <P>

     <DT><SPAN CLASS="InputHeader">View Issue Activity</SPAN>
      <DD>This link displays a snapshot page of changes made to an issue.
     <P>

     <DT><SPAN CLASS="InputHeader">Format For Printing</SPAN>
      <DD>This links redisplays the Issue View in a format for printing out. 

     <P>
     <DT><SPAN CLASS="InputHeader">Commit</SPAN>
      <DD>This button saves any modifications made to this issue. <B>Caution! When viewing an issue, the "Enter" key works like the <I>Commit</I> button. Any modifications you may have made (accidentally or otherwise) are saved and the issue's assignee and cc list receive email notification of activity on this issue.</B>

     <P><B><I>To exit out of viewing this issue without making any changes</I></B>, use the links at the top of this page or in the IssueZilla tool bar to view other issues, or the <I>Back</I> button in your browser. Even when you have changed fields, as long as you do not use the <I>Commit</I> button or the "Enter" key, the issue remains unchanged in the database.
     <P>

     <DT><SPAN CLASS="InputHeader">Reset</SPAN>
      <DD>Returns all fields to their <I>previously committed</I> values.
    </DL>
<P>

<HR NOSHADE SIZE=1>
<A HREF="Help.html">Back to main Help index</A></P></SPAN>
</SPAN>
</TR>
</TABLE>
@

