Recent changes to Tickets

Tickets modified by SourceForge Support

SourceForge Support — Wed, 25 Aug 2021 16:49:46 -0000

--- v35
+++ v36
@@ -1,6 +1,6 @@
 Tickets Overview

-SourceForge's ticket tracker tool is designed to allow for flexibility in how you track items of work that need to be completed. This includes bugs, feature requests from end users, or any other task you want to keep track of. You can even install **multiple ticket trackers** for different purposes. For example, a large project could have individual trackers for the design team, the documentation team, the developers, and another for support. Each of these trackers can have their own unique list of tickets, as well as custom fields, custom milestones, and their own "mailing list." Tickets can even be moved between tickets instances, even if they're on different projects.
+SourceForge's ticket tracker tool is designed to allow for flexibility in how you track items of work that need to be completed. This includes bugs, feature requests from end-users, or any other task you want to keep track of. You can even install **multiple ticket trackers** for different purposes. For example, a large project could have individual trackers for the design team, the documentation team, the developers, and another for support. Each of these trackers can have their unique list of tickets, as well as custom fields, custom milestones, and their own "mailing list." Tickets can even be moved between tickets instances, even if they're on different projects.

 [TOC]

@@ -8,18 +8,18 @@

 You may install or remove a ticket tracker via the "Add New..." link in the project menu bar.

-Once installed, for each tickets instance, there are a number of configuration options available. In addition to the common tool options of [permissions](/p/forge/community-docs/Project Permissions/), Rename and Delete, there are also these options specific to the Tickets tool:
+Once installed, for each tickets instance, there are several configuration options available. In addition to the common tool options of [permissions](/p/forge/community-docs/Project Permissions/), Rename, and Delete, there are also these options specific to the Tickets tool:

 ### Field Management

-* **Open Statuses**: A space delimited list of status options for Open tickets. All open tickets are shown on the default ticket list
-* **Closed Statuses**: A space delimited list of status options for Closed tickets. Closed tickets are not shown on the default ticket list, but are visible in various searches.
+* **Open Statuses**: A space-delimited list of status options for Open tickets. All open tickets are shown on the default ticket list
+* **Closed Statuses**: A space-delimited list of status options for Closed tickets. Closed tickets are not shown on the default ticket list, but are visible in various searches.
 * **Custom Fields**: See the [Custom Fields](#custom-fields) section for full details
 * **Default Fields**: Check the boxes of the default fields that you wish to display on list views like the default view, searches, milestones, etc.

 #### Custom Fields

-If you are an admin on a project you can add and delete custom fields for your tracker. Custom fields can be used to track everything from a list of components, to the relative size of the ticket, the QA person responsible for the ticket, or (hopefully) anything you can imagine. 
+If you are an admin on a project you can add and delete custom fields for your tracker. Custom fields can be used to track everything from a list of components to the relative size of the ticket, the QA person responsible for the ticket, or (hopefully) anything you can imagine. 

 You can edit the Custom Fields for the tracker via the **Field Management** page, found in the **Admin** section on the left sidebar of your ticket pages.

@@ -31,20 +31,20 @@
     * **Text**: Allows free form text
     * **Number**: is displayed as a free form text field, but will only allow numbers to be submitted
     * **Boolean**: a checkbox that can be checked or unchecked (ie., true/false)
-    * **Select**: Offers users a dropdown of preselected options. The options are space delimited, and a \* prefix will designate a default selection (otherwise the first option will be the default)
-    * **Milestone**: a milestone field is a special field which can be used to categorize tickets with an (optional) due date. Open milestones will automatically be added to the search bar on the side of the ticket views.
-    * **User**: a drop down that lists project members
+    * **Select**: Offers users a dropdown of preselected options. The options are space-delimited, and a \* prefix will designate a default selection (otherwise the first option will be the default)
+    * **Milestone**: a milestone field is a special field that can be used to categorize tickets with an (optional) due date. Open milestones will automatically be added to the search bar on the side of the ticket views.
+    * **User**: a drop-down that lists project members

 ### Edit Searches

-If you have a search that you want all users of the tracker to be able to share, you can save that search with a name, and it will be placed in the left navigation bar of the tracker for everybody to use. Commonly saved searches are "all open tickets," "all unassigned tickets," etc. You can use these saved searches to watch the flow of tickets through the system, and make it easier for your development team to focus on groups of active tickets.
+If you have a search that you want all users of the tracker to be able to share, you can save that search with a name, and it will be placed in the left navigation bar of the tracker for everybody to use. Commonly saved searches are "all open tickets," "all unassigned tickets," etc. You can use these saved searches to watch the flow of tickets through the system and make it easier for your development team to focus on groups of active tickets.

 Saved searches use the [search syntax](#searching-tickets).

 ### Options 

  * **Enable voting on tickets**: This will enable the voting feature which will let users vote tickets up or down. Votes will also be indexed in search, so you can search and sort by votes.
- * **Email ticket notifications to**: Most commonly used for sending ticket notifications to mailing lists. If you use a SourceForge Mailing list (or any other list based using Mailman) for email notifications, you may need to set the following settings in the Mailman administrator interface:
+ * **Email ticket notifications to**: Most commonly used for sending ticket notifications to mailing lists. If you use a SourceForge Mailing list (or any other list-based using Mailman) for email notifications, you may need to set the following settings in the Mailman administrator interface:
      *  For **Privacy Options -> Sender Filters -> accept_these_nonmembers**: `^[\w-]+@users\.sourceforge\.net`
      *  For **Privacy Options -> Recipient Filters -> acceptable_alias**: `\d+@\w[^.]+\.\w[^.]+\.p\.re\.sourceforge\.net`
  * **Help text**: This help text will be shown to users on new ticket pages and ticket listings respectively. This section may be markdown formatted.
@@ -54,7 +54,7 @@

 ### Integrated Comments and E-mail Subscriptions

-One of the fundamental features of the tracker is that every ticket is its own mini-mailing list.    Ultimately this idea comes from another bug tracker [roundup](http://roundup.sourceforge.net/) which called the idea _nosy lists_.   The idea is that everybody who edits or comments on a ticket is added to a mailing list (along with anybody who subscribes to that ticket).   That mailing list is integrated with the in-page comments for that ticket, and makes it easy to keep up with the tickets in various trackers that interest you. 
+One of the fundamental features of the tracker is that every ticket is its own mini-mailing list.    Ultimately this idea comes from another bug tracker [roundup](http://roundup.sourceforge.net/) which called the idea _nosy lists_.   The idea is that everybody who edits or comments on a ticket is added to a mailing list (along with anybody who subscribes to that ticket).   That mailing list is integrated with the in-page comments for that ticket and makes it easy to keep up with the tickets in various trackers that interest you. 

 If you have your e-mail address set up in your SourceForge account, you'll automatically be subscribed to any ticket you edit.   

@@ -64,7 +64,7 @@

 ### Integrated Markdown-Style Formatting Support

-Like the Wiki, the Discussion, and all of the other new forge tools, you can use markdown syntax to create rich formatting of your ticket text, or comments on tickets. For more information on using markdown syntax, see our [Markdown Syntax Guide](http://sourceforge.net/p/forge/documentation/markdown_syntax/).
+Like the Wiki, the Discussion, and all of the other forge tools, you can use markdown syntax to create rich formatting of your ticket text or comments on tickets. For more information on using markdown syntax, see our [Markdown Syntax Guide](http://sourceforge.net/p/forge/documentation/markdown_syntax/).

 ### Creating and editing tickets

@@ -78,13 +78,13 @@

 ### Private Tickets

-If a ticket is marked as private, the only people who can see it are the original ticket submitter and project Developers and Admins.  Other users will not be able to view the ticket, nor will they get email notifications for the ticket.
+If a ticket is marked as private, the only people who can see it are the original ticket submitter and project Developers, and Admins.  Other users will not be able to view the ticket, nor will they get email notifications for the ticket.

 ### Moving and Deleting Tickets

-To move a ticket, select the **Move** option in the upper right of the ticket view. This will then display all the valid ticket instances you have the proper permissions to move the ticket to. Any field values that can't be converted will be noted in the move message.
+To move a ticket, select the **Move** option in the upper right of the ticket view. This will then display all the valid ticket instances you have the proper permissions to move the ticket. Any field values that can't be converted will be noted in the move message.

-To delete a ticket, select the **Trash Can** icon in the upper right of the ticket view. This will now be "deleted", however it may still be "undeleted" if you select the **+** icon which replaces the **Trash Can** icon. If a deleted ticket matches a list view, there will be a "Show deleted tickets" link which will allow you to see them.
+To delete a ticket, select the **Trash Can** icon in the upper right of the ticket view. This will now be "deleted", however, it may still be "undeleted" if you select the **+** icon which replaces the **Trash Can** icon. If a deleted ticket matches a list view, there will be a "Show deleted tickets" link which will allow you to see them.

 ### Ticket Lists

@@ -92,7 +92,7 @@

 #### Searching tickets

-You can do full text searches for tickets at any time, but sometimes you want a bit more. You want to be able to filter results by milestone, or by who's working on the ticket, or by status, or some combination of the above.
+You can do full-text searches for tickets at any time, but sometimes you want a bit more. You want to be able to filter results by milestone, or by who's working on the ticket, or by status, or some combination of the above.

 Searches use the [solr lucene query syntax](http://www.solrtutorial.com/solr-query-syntax.html). On a search page, like the [Allura ticket search](/p/allura/tickets/search/), you'll see a "Help" button which will show the different available search fields and some search examples.

Tickets modified by Dave Brondsema

Dave Brondsema — Mon, 24 Sep 2018 15:56:20 -0000

--- v34
+++ v35
@@ -45,8 +45,8 @@

  * **Enable voting on tickets**: This will enable the voting feature which will let users vote tickets up or down. Votes will also be indexed in search, so you can search and sort by votes.
  * **Email ticket notifications to**: Most commonly used for sending ticket notifications to mailing lists. If you use a SourceForge Mailing list (or any other list based using Mailman) for email notifications, you may need to set the following settings in the Mailman administrator interface:
-     *  For **Privacy Options -> Sender Filters -> accept_these_nonmembers**: `^[\w-]+@users\.sf\.net`
-     *  For **Privacy Options -> Recipient Filters -> acceptable_alias**: `\d+@\w[^.]+\.\w[^.]+\.p\.re\.sf\.net`
+     *  For **Privacy Options -> Sender Filters -> accept_these_nonmembers**: `^[\w-]+@users\.sourceforge\.net`
+     *  For **Privacy Options -> Recipient Filters -> acceptable_alias**: `\d+@\w[^.]+\.\w[^.]+\.p\.re\.sourceforge\.net`
  * **Help text**: This help text will be shown to users on new ticket pages and ticket listings respectively. This section may be markdown formatted.

Tickets modified by Dave Brondsema

Dave Brondsema — Thu, 14 Jan 2016 20:59:10 -0000

--- v33
+++ v34
@@ -6,9 +6,9 @@

 ## Configuring Tickets

-You may install or remove a ticket tracker via **Admin -> Tools**.
+You may install or remove a ticket tracker via the "Add New..." link in the project menu bar.

-Once installed, for each tickets instance, there are a number of configuration options available. In addition to the common tool options of [permissions](/p/forge/community-docs/Project Permissions/), Label and Delete, there are also these options specific to the Tickets tool:
+Once installed, for each tickets instance, there are a number of configuration options available. In addition to the common tool options of [permissions](/p/forge/community-docs/Project Permissions/), Rename and Delete, there are also these options specific to the Tickets tool:

 ### Field Management

Tickets modified by Dave Brondsema

Dave Brondsema — Thu, 17 Dec 2015 23:22:56 -0000

--- v32
+++ v33
@@ -21,7 +21,7 @@

 If you are an admin on a project you can add and delete custom fields for your tracker. Custom fields can be used to track everything from a list of components, to the relative size of the ticket, the QA person responsible for the ticket, or (hopefully) anything you can imagine. 

-You can edit the Custom Fields for the tracker under **Admin** -> **Tools** for your project. Where your "tickets" instance is mentioned, select **Field Management**
+You can edit the Custom Fields for the tracker via the **Field Management** page, found in the **Admin** section on the left sidebar of your ticket pages.

 There's a button there to add a new field. Custom fields have the following options:

Tickets modified by Dave Brondsema

Dave Brondsema — Tue, 08 Sep 2015 15:16:53 -0000

--- v31
+++ v32
@@ -78,7 +78,7 @@

 ### Private Tickets

-If a ticket is marked as private, only "Developers" on the project and the original ticket submitter will be able to view it.  Other users will not be able to view the ticket, nor will they get email notifications for the ticket.
+If a ticket is marked as private, the only people who can see it are the original ticket submitter and project Developers and Admins.  Other users will not be able to view the ticket, nor will they get email notifications for the ticket.

 ### Moving and Deleting Tickets

Tickets modified by Dave Brondsema

Dave Brondsema — Tue, 08 Sep 2015 15:13:04 -0000

--- v30
+++ v31
@@ -76,6 +76,10 @@

 Tickets may also be created and edited using the [Allura API].

+### Private Tickets
+
+If a ticket is marked as private, only "Developers" on the project and the original ticket submitter will be able to view it.  Other users will not be able to view the ticket, nor will they get email notifications for the ticket.
+
 ### Moving and Deleting Tickets

 To move a ticket, select the **Move** option in the upper right of the ticket view. This will then display all the valid ticket instances you have the proper permissions to move the ticket to. Any field values that can't be converted will be noted in the move message.

Tickets modified by

Wed, 09 Apr 2014 13:51:41 -0000

Tickets modified by

Fri, 26 Apr 2013 16:33:49 -0000

--- v28
+++ v29
@@ -44,7 +44,7 @@
 ### Options

  * **Enable voting on tickets**: This will enable the voting feature which will let users vote tickets up or down. Votes will also be indexed in search, so you can search and sort by votes.
- * **Email ticket notifications to**: Most commonly used for sending ticket notifications to mailing lists. If you use a SourceForge Mailing list (or any other list based using Mailman) for email notifications, you may need to set the following settings:
+ * **Email ticket notifications to**: Most commonly used for sending ticket notifications to mailing lists. If you use a SourceForge Mailing list (or any other list based using Mailman) for email notifications, you may need to set the following settings in the Mailman administrator interface:
      *  For **Privacy Options -> Sender Filters -> accept_these_nonmembers**: `^[\w-]+@users\.sf\.net`
      *  For **Privacy Options -> Recipient Filters -> acceptable_alias**: `\d+@\w[^.]+\.\w[^.]+\.p\.re\.sf\.net`
  * **Help text**: This help text will be shown to users on new ticket pages and ticket listings respectively. This section may be markdown formatted.

Tickets modified by

Fri, 12 Apr 2013 20:57:25 -0000

--- v27
+++ v28
@@ -1,5 +1,3 @@
-[[include ref=in-progress]] 
-
 Tickets Overview

 SourceForge's ticket tracker tool is designed to allow for flexibility in how you track items of work that need to be completed. This includes bugs, feature requests from end users, or any other task you want to keep track of. You can even install **multiple ticket trackers** for different purposes. For example, a large project could have individual trackers for the design team, the documentation team, the developers, and another for support. Each of these trackers can have their own unique list of tickets, as well as custom fields, custom milestones, and their own "mailing list." Tickets can even be moved between tickets instances, even if they're on different projects.

Tickets modified by

Thu, 11 Apr 2013 20:39:55 -0000

--- v26
+++ v27
@@ -51,8 +51,6 @@
      *  For **Privacy Options -> Recipient Filters -> acceptable_alias**: `\d+@\w[^.]+\.\w[^.]+\.p\.re\.sf\.net`
  * **Help text**: This help text will be shown to users on new ticket pages and ticket listings respectively. This section may be markdown formatted.

-**Note**: 
-

 ## Using Tickets

@@ -72,9 +70,25 @@

 ### Creating and editing tickets

-**TODO**
+With the appropriate permissions, you can create a new ticket using the **Create Ticket** link in the left sidebar. Then fill in a title, any appropriate fields, and an issue description.

-### Searching tickets
+If you want to edit the main ticket description or fields on an existing ticket (again, assuming appropriate permissions), select the **EDIT** button in the upper right of a ticket. This view is similar to the new ticket view, except it doesn't display any new ticket help text, and there's space at the bottom to provide a comment for the edit.
+
+If you just want to further discussion about a ticket, just use the comment field at the bottom.
+
+Tickets may also be created and edited using the [Allura API].
+
+### Moving and Deleting Tickets
+
+To move a ticket, select the **Move** option in the upper right of the ticket view. This will then display all the valid ticket instances you have the proper permissions to move the ticket to. Any field values that can't be converted will be noted in the move message.
+
+To delete a ticket, select the **Trash Can** icon in the upper right of the ticket view. This will now be "deleted", however it may still be "undeleted" if you select the **+** icon which replaces the **Trash Can** icon. If a deleted ticket matches a list view, there will be a "Show deleted tickets" link which will allow you to see them.
+
+### Ticket Lists
+
+The default view will show all open tickets, most recent first. Open milestones are listed on the left sidebar and will each generate a list view for each milestone.
+
+#### Searching tickets

 You can do full text searches for tickets at any time, but sometimes you want a bit more. You want to be able to filter results by milestone, or by who's working on the ticket, or by status, or some combination of the above.

@@ -82,4 +96,5 @@

 #### Bulk Edit

-To edit a group of tickets all at once, just start with any search that returns the tickets you want -- and then click the **Bulk Edit** button at the upper right of that page (ie., the pencil icon). Check the boxes on the tickets you want to edit, and enter the new values for the tickets in the form provided.
+To edit a group of tickets all at once, start with a list view, and then click the **Bulk Edit** button at the upper right of that page (ie., the pencil icon). Check the boxes on the tickets you want to edit, and enter the new values for the tickets in the form provided.
+