The Trac Roadmap
Table of Contents
The roadmap provides a view on the ticket system that helps planning and managing the future development of a project.
The Roadmap View
A roadmap is a list of future milestones. The roadmap can be filtered to show or hide completed milestones and milestones with no due date. In the case that both show completed milestones and hide milestones with no due date are selected, completed milestones with no due date will be shown.
The Milestone View
A milestone is a future timeframe in which tickets are expected to be solved. You can add a description to milestones (using WikiFormatting) describing main objectives, for example. In addition, tickets targeted for a milestone are aggregated, and the ratio between active and resolved tickets is displayed as a milestone progress bar. It is possible to further customise the ticket grouping and have multiple ticket statuses shown on the progress bar.
It is possible to drill down into this simple statistic by viewing the individual milestone pages. By default, the active/resolved ratio will be grouped and displayed by component. You can also regroup the status by other criteria, such as ticket owner or severity. Ticket numbers are linked to custom queries listing corresponding tickets.
With appropriate permissions it is possible to add, modify and remove milestones using either the web interface (roadmap and milestone pages), web administration interface or by using trac-admin.
Note: Milestone descriptions can not currently be edited using 'trac-admin'.
The Roadmap supports the iCalendar format to keep track of planned milestones and related tickets from your favorite calendar software. Many calendar applications support the iCalendar specification including
- Apple iCal for Mac OS X
- the cross-platform Mozilla Calendar
- Korganizer, the calendar application of the KDE project
- Microsoft Outlook can also read iCalendar files and appears as a new static calendar in Outlook
- Google Calendar
To subscribe to the roadmap, copy the iCalendar link from the roadmap (found at the bottom of the page) and choose the "Subscribe to remote calendar" action (or similar) of your calendar application, and insert the URL just copied.
Note: For tickets to be included in the calendar as tasks, you need to be logged in when copying the link. You will only see tickets assigned to yourself and associated with a milestone.
Note: To include the milestones in Google Calendar you might need to rewrite the URL.
RewriteEngine on RewriteRule ([^/.]+)/roadmap/([^/.]+)/ics /$1/roadmap?user=$2&format=ics
More information about iCalendar can be found at Wikipedia.