---
title: Managing the GitHub boards
source: https://docs.newrelic.com/docs/agile-handbook/heroing/managing-the-github-boards
---

The [Docs pull requests and Issues](https://github.com/newrelic/docs-website/projects/3) board is our source of truth for what's going on in our project. The board is divided into a series of columns so we can see visually what the status of each issue and pull request is.

## A note on Assignee vs Reviewer [#assignee_reviewer]

Assignee and Reviewer have different meanings:

-   **Assignee** means you own the pull request or issue and are getting it into a merge-ready state. If you are no longer owning a given pull request or issue, take your name off as assignee.
-   **Reviewer** means you are actively reviewing a pull request. If it's a pull request from outside the docs team, the reviewer is also responsible for merging the pull request into `develop`. If you're reviewing a pull request from a fellow docs writer, add your comments and mark the pull request as **Approved**, then move it to **Waiting on TW to merge**.

## Drafts column [#column_drafts]

These issues and pull requests are in a draft state. Do not merge until their owner moves them out of the column. This column should _only_ be for draft pull requests. Do not "hold" pull requests or issues here.

The Hero should look at this column multiple times per day in case a pull request has been marked ready for review. Move any ready-for-review pull requests into the correct column.

## Hero to triage column [#column_hero-to-triage]

New issues and pull requests flow into this column automatically. As hero, you need to triage each one:

1.  Determine if the pull request or issue is content-related. If it's an eng issue or pull request, you can just **Archive** it to remove it from the board.
2.  Assign mandatory labels:
    Label type

    Required on

    Description



    content

    Issues and pull requests

    Use this label to indicate an issue or pull request relates to content (versus the code of the site).


    from\_

    Issues and pull requests

    Use this label to indicate who created the issue or pull request. Use from_tw when it's created by a docs writer, from_internal when it's created by a Relic, and from_external when  it's from outside the company.


    pg\_

    Issues

    Indicates which New Relic product group is associated with this issue.
3.  Give the ticket an assignee (most likely you).
4.  Move the ticket to the appropriate column.

## Hero: To do column [#column_hero-to-do]

Work that the GitHub has triaged, but hasn't started working on yet. Tickets in this column need to have an assignee.

## In progress/being reviewed column [#column_in-progress]

Work is underway on this issue or pull request. For example, reviewing pull requests from outside the team, doing a peer edit, investigating a GitHub issue. The person doing the work should make themselves the assignee as soon as they move the pull request or issue into this column to prevent others from duplicating work.

## Writer needs PR review column [#column_writer-pr-review]

Exactly what it says. Typically, the writer who submitted the pull request will move it to this column.

A pull request review means reviewing for basic stuff like is it rendering correctly, are there typos or wording issues, and are there any obvious errors in the .mdx content shown in the diff. Once you've reviewed the pull request, mark it approved in the GitHub review UI, and move it to the **Waiting on TW to merge** column.

## Writer needs peer edit column [#column_writer-peer-edit]

Also exactly what it says. As with pull request review column, the writer who submitted the pull request will drag to this column.

This includes all the stuff in a pull request review plus an actual peer edit. Once you've reviewed the pull request and left your feedback in the GitHub review UI, mark it **Approved** and move it to the **Waiting on TW to merge** column. From there, the author of pull request is responsible for reviewing the feedback and updating it before merging. If you find significant issues (inaccuracies, bad formatting, build issues), don't mark it **Approved**.

## Waiting on SME/blocked column [#column_waiting-on-sme-blocked]

Blocked until something else happens. Usually this means it's waiting on answers or approval from the SME or the person who submitted the pull request.

## Waiting on TW to merge column [#column_waiting-on-tw-merge]

When a docs writer creates a pull request, it's their responsibility to merge it into `develop` at the appropriate time. After a reviewer is done with their pull request review or peer edit, they move it into this column so the original writer can merge when ready.

[← What is a hero?](https://docs.newrelic.com/docs/agile-handbook/heroing/what-is-a-hero/)

[Appendix: Ticket best practices →](https://docs.newrelic.com/docs/agile-handbook/appendices/ticket-best-practices/)
