Pivotal Tracker

You should have an account set up on Pivotal Tracker already. If not, you should contact Fraser.

There are two main projects that you might be interested in:

• Development
• Company

Development

This project is used to keep track of practically anything code related. As such, it is mostly used by developers.

Workflow

• If you have an idea, or have found a bug, it should be added to the Icebox. Elements in the Icebox will gradually make their way to the Backlog / Current as items are prioritized
• The Backlog / Current columns represent stories that have been prioritized.
  • Stories are prioritized and cleaned up by the development lead
  • The Current column lists stories that have been prioritized, and are likely to be completed in the current iteration based on our velocity.
  • The Backlog column lists stories that have been prioritized but won't be completed this iteration. Pivotal will attempt to estimate when stories will be completed based on our velocity.
• When starting a story, you should pick one from the top-most of the Current column, and be sure to press the Start button (and, of course, branch your work off of the dev branch)
  • If you are working on something that is not in the backlog (shame!) do make sure that it is added
• When work is done on a story, and you're ready to have it reviewed and integrated into dev, submit a pull request, and press Finish in pivotal
• After your work has been reviewed, you can press the Deliver button. Congratulations! You're almost there!
• Continue testing everything out, now on the dev branch. If you encounter any problems, fix them in your branch, and submit a new pull request.
• If everything is Ok'd by Fraser, the story will be Accepted, and will be pushed live with the next release.

Github Integration

Pivotal is integrated with Github, provided your commits follow a certain format. The format is as follows:

[#STORY_ID] Normal commit message

You can also change the state of a pivotal story by doing this. If a story has not been started, your commit will automatically start the story.

[Finished #STORY_ID] Finished a story

More details can be found on the Pivotal API page.

! "Finish"ing a bug or a chore will turn them into the accepted state.

Please remember to create Pivotal stories for tasks you are working on, and to link the ID to your commits. This provides valuable information around what we are working on and how we are working.

Ratings

• 0 stars: can finish in less than a day
• 1 star: can finish in a day or two
• 2 stars: can finish in less than a week
• 3 stars: will take a week and up