Table of Contents
Using Trac for NCCOOS Projects
This page describes how to use the Trac System for projects run by NCCOOS. It contains general how-to notes for getting started and day-to-day details of Trac focused on working in a team and/or maintaining a project as a team-leader. Add to this page as you find useful info and how-tos related to Trac and SVN.
Trac System
Trac is a minimalistic approach to web-based management of software projects. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress. By integrating web-based documentation tool (wiki) with bug tracking or enhancement features (tickets), and code repository, the Trac System allows distributed teams of people to collaborate remotely on a software and documentation project.
For Team Members
Tickets
- Change the status of a ticket from 'new' to 'accepted' when you start work on the ticket. It's fine to start work, drop it and come back to the ticket later.
- Make use of TracLinks in the original description of the ticket to refer to other tickets and to wiki documentation.
Modifying Code
For the Project Leader(s)
- Creating a subversion (SVN) repository
- Setting up Trac components and projects
- Start wiki pages to point to code of interest Create page here to talk about how to tie tickets and svn versions numbers together
Milestones
- For small projects, use a single Milestone to define the project. Breakdown the project into a collection of tickets that are in the 'Task' Category and assign them to the milestone. When a new tasks are added, be sure to mark them as part of this milestone.
- Use a short paragraph describing the milestone's overall objective. Then create tickets for each item of the to-do list with Category set to Task for each.
Wiki
Resources
- TracGuide -- Built-in Documentation -- The Trac User and Administration Guide with useful info like WikiFormatting, WikiMacros, and TracLinks
- The Trac project -- Trac Open Source Project
- Subversion -- Open source version control system
- Version Control with Subversion -- A free online book about Subversion published by O'Reilly Media
- TortoiseSVN-- A Subversion client, implemented as a windows shell extension