Boot.dev has been my side-project for the last couple of years now. Being a learning path for backend developers focused on quality over quantity, I knew early on that it needed to have a feedback loop from students. We had (and still have) a Discord server where myself and the students hang out, and that worked okay at first. really tight Unfortunately, Discord channels have a couple of problems when it comes to issue tracking: Long conversations make it hard to keep track of individual reports There's no way to "resolve" a "ticket" Not all students are on the Discord There is more friction to report issues in a different application The solution that has been working splendidly for me so far was to add a feedback box directly within each coding assignment! Now students can easily report issues with the near-zero hassle. Unfortunately, running SQL queries to get at those submitted issues is a giant pain... . The Github API has entered the chat Using Github issues to track user feedback I have a private Github repo where I store all the content for the computer science courses on Boot.dev in markdown files. It would be if user-reported issues automatically manifested as Github issues on that repository! really convenient After just a few minutes of digging, I realized it was quite easy to do with the Github API. Given that my backend is a REST-ish API written in Go. I decided to use and the official . Google's Github API client package Golang oauth2 package If you're interested in following along, first you need is a with "repo" permissions. personal access token Next, I created a package in my project to manage interactions with the Github API. It exposes a struct: githubclient Client // Client -
type Client struct {
    githubClient *github.Client
}

// NewClient -
func NewClient(personalAccessToken string) (Client, error) {
    ctx := context.Background()
    ts := oauth2.StaticTokenSource(
        &oauth2.Token{AccessToken: personalAccessToken},
    )
    tc := oauth2.NewClient(ctx, ts)

    client := github.NewClient(tc)

    _, ghResp, err := client.Issues.List(ctx, false, nil)
    if err != nil {
        return Client{}, err
    }
    if ghResp.StatusCode > 299 {
        dat, err := io.ReadAll(ghResp.Body)
        if err != nil {
            return Client{}, err
        }
        return Client{}, fmt.Errorf("status code: %v, message: %v", ghResp.StatusCode, string(dat))
    }

    return Client{
        githubClient: client,
    }, nil
} You'll notice that I added some logic to list the issues. We don't actually do anything with those issues, and you can remove that code if you want. For me, it was useful to test that the token is working on the application startup. Next, I wrote a simple method on the client: CreateIssue() // CreateIssue creates an issue in the example-org/example-repo repository
func (c Client) CreateIssue(exercisePath, fromUsername, userComment string) error {
    ctx := context.Background()
  const repoName = "example-repo"
  const orgName = "example-org"

    summary := userComment
    const summaryLength = 20
    if len(summary) > summaryLength {
        summary = summary[:summaryLength]
    }

    title := fmt.Sprintf("exercise: %v, Summary: %v", exercisePath, summary)
    body := fmt.Sprintf(`
Comment: %v

From: %v
`, userComment, fromUsername)

    _, ghResp, err := c.githubClient.Issues.Create(ctx, orgName, repoName, &github.IssueRequest{
        Title:  &title,
        Body:   &body,
        Labels: &[]string{"course-feedback"},
    })
    if err != nil {
        return err
    }

    if ghResp.StatusCode > 299 {
        dat, err := io.ReadAll(ghResp.Body)
        if err != nil {
            return err
        }
        return fmt.Errorf("status code: %v, message: %v", ghResp.StatusCode, string(dat))
    }
    return nil
} As you can see, given an... exercise path (which is just the filepath to the exercise receiving feedback) username of the reporter comment from the reporter The method simply creates a new issue in the repo with a static label. I've split the inputs into a Github issue "title" and "body" that's formatted to my needs so that I can resolve the issues as quickly as possible. CreateIssue Why not use an out-of-the-box solution I know there are a billion and a half issue tracking tools you can buy on the market, but I really liked this solution for a few reasons: It took about an hour to code from start to finish It's free It's integrated with the tooling I already use daily (GitHub) If you need a simple issue tracker for your app I'd recommend looking into using Github issues via the API, at least until it stops working for you! Also published . here

Google

Top 10 Job Boards Where You Can Find Your Next Software Engineering Job

Why You Need to Learn Multiple Programming Languages 

Learn to code on Boot.dev

Nominated for 2022 - HackerNoon Contributor of the Year - Algorithms

Nominated for 2022 - HackerNoon Contributor of the Year - Mathematics

Nominated for 2022 - HackerNoon Contributor of the Year - Cryptography

Nominated for Coding Guru of 2022

Nominated for 2022 - HackerNoon Contributor of the Year - Github

Nominated for 2022 - HackerNoon Contributor of the Year - Online Education

Nominated for 2022 - HackerNoon Contributor of the Year - Job Hunting

Nominated for Super Career Strategist of 2022

Too Long; Didn't Read

Now You Can Use GitHub Issues to Track Customer Feedback

Now You Can Use GitHub Issues to Track Customer Feedback

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

A Complete Overview of Cryptography

11 Customer Feedback Software that Would Revolutionize 2022

35 Stories To Learn About Feedback

7 Critical Customer Satisfaction Metrics You Need to Measure

Analyzing ChatGPT's New Features: A Comparative Insight With Migned

Create Better Customer Experience Plus Brand Persona With Feedback

A Complete Overview of Cryptography

11 Customer Feedback Software that Would Revolutionize 2022

35 Stories To Learn About Feedback

7 Critical Customer Satisfaction Metrics You Need to Measure

Analyzing ChatGPT's New Features: A Comparative Insight With Migned

Create Better Customer Experience Plus Brand Persona With Feedback

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps