Skip to content

Instantly share code, notes, and snippets.

@lostphilosopher
Last active August 29, 2015 14:24
Show Gist options
  • Save lostphilosopher/e370680a8c0bcba2925f to your computer and use it in GitHub Desktop.
Save lostphilosopher/e370680a8c0bcba2925f to your computer and use it in GitHub Desktop.
Bug Reporting and Feature Tracking for Garage Projects

Bug Reporting and Feature Tracking for Garage Projects

##Summary

To keep teams in sync and working quckly all project / work / issue conversations should be documented in Trello, and not in emails, chats, etc.

If you have a future feature idea, or bug to report - put it on Trello and you can safely assume it's on the design / dev team's radar. If you need immediate response or feedback, reference the team member with the @ sign.

##Documenting a Future Feature / Bug Report in Trello

  1. If relevant, take a screenshot of your whole screen (full browser window) where you're experiencing the bug or envisioning the feature.
  2. Go to Trello find your project's board and click "Add a card" in the appropriate column. (Not sure what the right column is? Default to the furthest left column and ask your team!)
  3. Name the card with a short summary of the feature / bug.
  4. Click the green "Add" button.
  5. Click your freshly made card again to bring up a window where you can add more information and attachements.
  6. Click the "Edit the description..." link and describe the feature / bug.
  7. If relevant, use the "Attachment" link on the right to include screenshots, mock ups, etc to help explain the feature / bug.
  8. Feel free to ask questions or start discussions in the column feed at the bottom of the card (and take advantage of the @ feature to notifiy a specific teammember that you've got a question for them.

##More Info

##Source of Truth

Since most development and design work is taken directly from the project's Trello board it's important to treat it as the "single source of truth." Any chunk of work that needs doing (even far future work) belongs on Trello, and decisions made about that piece of work must be on Trello. This keeps teams in sync.

Trello cards should also house links to all of the assets (images, copy, urls, etc.) necessary to complete the work defined on the card.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment