Skip to content

Instantly share code, notes, and snippets.

@h13i32maru h13i32maru/jasper.md
Last active May 17, 2017

Embed
What would you like to do?
Jasper - The Issue Reader for GitHub

I am Japaneses, so this post might be written with broken English. sorry

Overview

Jasper is the issue reader for GitHub/GHE. This is similar to e-mail client or RSS reader. You can read/unread management, mark star, archive issues and etc. Jasper provides the core feature called "Stream" in order to realize operation same as these client. I will explain how to use the Stream this time.

ss

How to use "System"

Before how to use the "Stream", I will explain how to use "System" feature that is created automatically with Jasper. Basically you just check the System, I think that you does not miss issues related to their own.

your_issues

  • Me shows issues you are involved in and of your repositories (created, assigned, commented or mentioned).
  • Team shows issues your team is mentioned in.
  • Watching shows issues of repository you watch.
  • Subscription shows issues you subscribed to with Jasper. this does not connect subscription of GitHub.

How to use Stream

I will exaplain how to use the Stream for a private and for a business.

stream

for Private

You will use github.com for private work.

  • Read own issues/PRs
    • author:myUserName
    • You can notice old PRs that recently became active
  • Read issues/PRs in organization which you belong to
    • user:myOrg1 user:myOrg2
    • I think helpful that specify interested organiztions which you deos not belong to
  • Egosurfing with my tool, my library and etc
    • mytool OR mylib
    • You can exclude your organizations, bot user and more: -user:userX -user:orgX -author:botX mytool OR mylib
  • Read issues/PRs that famous users at OSS involves in
    • involves:userA involves:userB
    • involves:userA means "userA created, was assigned, commented to or was mentioned in"

for Business

You will use GHE for business work.

  • Read own issues/PRs
    • author:myUserName
  • Read the team member's PRs
    • is:pr author:member1 author:member2
    • You can see WIP PRs before you are mentioned in.
  • Read issues/PRs in your department organization
    • user:myDepartmentOrg
    • You can specify normal user name in user:
  • Read issues/PRs in other department organizations
    • user:infraOrg user:salesOrg
  • Read issues/PRs that has both bug and api labels in your organization
    • user:myDepartmentOrg label:bug label:api
    • A multi label behave "AND" condition
  • Read issues/PRs in version 1.0.0 milestone
    • milestone:v1.0.0
  • Egosurfing with words related to your work
    • mytool OR mylib
  • Read todo issues in your todo repository
    • repo:myUserName/todo
    • The repository should be private
  • Read daily report issues
    • label:daily author:userA author:userB

There are many other queries in addition to this explain. For example, author:myUserName org:myDepartmentOrg label:bug are mixed query. The explain for other queries are here

Next time, I will explain Filter that is sub feature of Stream.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.