User Stories

User Type	Description
User	Any user, authenticated or not
Authenticated User	A user who has authorized the app with their GitHub account and has unrestricted functionality available
Developer	The application developer

General

As a user, I want a stable and bug free app experience
As a user, I want a simple on-boarding tutorial, so I can learn the apps primary functions quickly
As a user, I want a clean and intuitive interface, so I can easily understand how to use the app
As a user, I want the interface to resemble existing standards and workflows, so I can carry over knowledge from other software I use
As a user, I want to list starred repositories on an account
As a user, I want to filter repos by search term
As a user, I want to filter repos by predefined search terms
As a user, I want to create reusable search terms (tags)
As a user, I want to add specific tags to repos, so I can find them later when I need them
As a user, I want to remove tags from repos
As a user, I want to copy tags from one repo to another
As a user, I want the app to suggest useful tags, to speed up the tagging process
As a user, I want to quickly add tags to my search criteria
As a user, I want to edit existing tags, so I can refine my search terms as I learn best practices
As a user, I want to change tag colors
As a user, I want my edits to propagate to all previously tagged repos
As a user, I want icons on my tags, so I can identify them quickly
As a user, I want to search my tags by search term, so I can find them quickly
As a user, I want repos to have sensible default tags
As a user, I want to use multiple tags and search terms in a single search
As a user, I want feedback on how many repos use specific tags
As a user, I want to remove search terms from an active search
As a user, I want flexible result filtering, so my search terms do not need to be perfect
As a user, I want to see what GitHub account the app is linked to, so I can be sure I'm using the correct account
As a user, I want to quickly jump to repositories on GitHub for more information
As a user, I want to know what changed when the app updates
As a user, I want to control what data is gathered by the developer and why it is gathered
As a user, I want to limit what data is gathered by the developer
As a user, I want feedback on my repo tag maintenance, so I can better configure tags to work with my repos
As a user, I want the app to integrate with GitHub's existing UI, so I can manage my stars without changing context
As a user, I want to change the layout of my search results, so I can optimize how I scan through search results
As a user, I want to change the sorting order of search results, so I can sort results according to my needs
As a user, I want feedback when the app is working asynchronously, so I know the app has not crashed when it's busy
As a user, I want to learn more about the developer and the project

Authenticated Stories

As an authenticated user, I want to know what permissions are need and why, so I can feel safe allowing access to my account
As an authenticated user, I want to select what permissions I want to give, so I can limit access to my account
As an authenticated user, I want to sync my settings with another instance of the app, so I can keep my settings across multiple computers
As an authenticated user, I want to include private repos in my search results
As an authenticated user, I want to quickly un-star repos, so I can remove repos I am no longer interested in

Feedback

As a user, I want to report bugs to the developer
As a user, I want to make feature requests for the developer
As a user, I want to rate the app, so other users know that I like/dislike it
As a user, I want to support development of the project monetarily

Developer

As a developer, I want to gracefully handle changes in user permissions outside the application, so I can react to users changing permissions directly on GitHub
As a developer, I want to securely manage authentication tokens