User Stories

The following is a set of initial user stories. These stories are the starting point for creating Issues detailing actionable tasks for development.

User Types

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

User Stories

General
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
Searching and tagging
As a user, I want to filter repos by search term
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
Interface
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
Authentication
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 and support
As a user, I want to learn more about the developer and the project
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 an initial tech stack set up, so I can begin development
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
As a developer, I want a logo to make the app recognizable to users at a glance
As a developer, I want a stable and bug free app experience