Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Add documentation about the project and how to build it.

  • Loading branch information...
commit f7bbfecf43a9956ed3055db4bdffa2b5a273cdca 1 parent 51028f0
Allen abierbaum authored
Showing with 40 additions and 3 deletions.
  1. +40 −3 README.md
43 README.md
View
@@ -1,4 +1,41 @@
-pivotal-tracker-tweaks
-======================
+# pivotal-tracker-tweaks Chrome Extension
-Chrome Extension that provides tweaks to the pivotal tracker site.
+Overview
+========
+
+This is a chrome extension that provides a variety of tweaks to help make pivotal tracker more useful for our workflow. It includes the following tweaks:
+
+* Prevent Epics from being auto completed
+
+By default PT will automatically handle epics and mark them as done as soon as any stories from an epic have been marked as done and there are no other stories for that epic in the backlog. This doesn't work well for a workflow where you want to use epics to group items from the icebox that may not yet be scheduled. This change removes this default behavior and prevents epics from ever being marked as completed or done.
+
+* Only allow one Epic story panel to open at a time
+
+When clicking on epics and opening epics from the Epic list panel, the default behavior is to continue opening one new panel for each epic you click on. This makes it difficult to rapidly scan through a number of epics looking at their detailed stories. The extensions changes this behavior and will close all epic story panels before opening the new panel.
+
+* Allow dragging of panels
+
+We include the excellent extension for allowing rearrange_panels.
+
+See: https://chrome.google.com/webstore/detail/rearrange-panels-in-pivot/opjidnmongipncgdeggklmjihpmjollh
+
+Installation
+============
+
+1. Download the latest .crx file from the build/ directory.
+2. Open 'chrome://extensions'
+3. Drag and drop the .crx file onto the extensions page.
+
+Building
+========
+We use grunt and node for the build. On most systems this should be very easy to use.
+
+1. Make sure node.js is installed on your system
+2. Go to the base directory for the extension
+3. Run 'npm install'
+4. Run './node_modules/.bin/grunt build'
+5. The extension should now be located in the build directory.
+
+Contributing
+============
+Please fork the repository and add new features.
Please sign in to comment.
Something went wrong with that request. Please try again.