Enter your Pivotal Tracker API Token
What Is This About?
Sluglug is a service that automagically adds human readable identifiers to stories from Pivotal Tracker , a widely used Agile project management tool.
Why Is This Needed?
Tracker identifies stories with a global number shared by all projects. As of this writing, newly generated story ids are in the ten million range. An 8-digit number is very impractical to refer to verbally. Sluglug lessens the pain of communicating the reference to a specific story to another human being by assigning name prefixes ("The Slug") to each story.
What Does the Slug Look Like?
Slugs are derived from the names of US cities. They are lower cased and blank spaces replaced with hyphens. They are enclosed in square brackets and added at the front of the story title. For example a slugged story title could look like: "[hilton-village] Little Red Riding Hood is going through the dark woods to get to Grandmother's." Take a look for yourself by experimenting in the Sluglug demo project in Tracker.
Are Slugs Unique?
No. Slugs are assigned to a story by hashing the story id and as such can be reassigned to other stories. However, it's unlikely (but not impossible) that two backlog stories would be assigned the same slug.
Where Can I Find My Tracker API Token?
In Tracker, click on PROFILE and scroll down to API Token section. Copy the 32-character code.
Which Stories Are Slugified?
Newly created feature stories, chores and bugs. Milestones and externally imported stories are left alone. Also, stories created prior to enabling Sluglug will not be updated.
What If Someone Else In My Team Already Turned Slugging On?
Anyone with a valid Tracker API Token can turn slugging on/off for projects they have access to. Simply login with your own Tracker API Token and switch your project on or off.
How Do I Report a Problem?
Create a ticket in http://sluglug.lighthouseapp.com/
What's With the Slug Theme?
In web publishing, a slug is the part of a URL which identifies a page using human-readable keywords. It's also a gastropod mollusc that lacks a shell and makes a nice mascot.