Projects
About project boards
Project boards on GitHub help you organize and prioritize your work. You can create project boards for specific feature work, comprehensive roadmaps, or even release checklists.
Project boards are made up of issues, pull requests, and notes that are categorized as cards in columns of your choosing. Cards can be moved from column to column and reordered according to your needs.
Project board cards contain relevant metadata for issues and pull requests, like labels, assignees, the status, and who opened it. To see more details about the issue or pull request, you can easily navigate to it by clicking the link within the card.
You can create notes within columns to serve as task reminders or to add information related to the project board. If the note isn't sufficient for your needs, you can convert it to an issue.
There are two types of project boards:
- Repository project boards are scoped to issues, pull requests, and notes within a single repository.
- Organization-wide project boards can contain issues and pull requests from any repository that belongs to an organization.
Note: Anyone with read access to a repository can view the repository's project boards. To create a project board, you must have write access to the repository.
Creating a repository project board
On GitHub, navigate to the main page of the repository.
Under your repository name, click Projects.
Click New Project.
Type a project board name and a description of the project board and click Save Project.
Click Add column to add your first column to your project board.
6) Type the column name and click Create column.
7) Add additional columns to best suit your workflow.
Adding notes to a repository project board
On GitHub, navigate to the main page of the repository.
Under your repository name, click Projects.
In the projects list, click the project board you want to add notes to. Make sure your project board has at least one column.
In the column you want to add a note to, click the + icon.
5) Type your note and click Add note.
Converting a note to an issue
If you've created a note and find that it isn't sufficient for your needs, you can convert it to an issue.
When you convert a note to an issue, the issue is automatically created using the content from the note. The first line of the note will be the issue title and any additional content from the note will be added to the issue description.
- Navigate to the note that you want to convert to an issue.
- Click the dropdown.
3) Click Convert to issue.
4) Pick the repository you want to add the issue to.
5) Confirm that you want to convert the note to an issue by clicking OK.
6) The note is automatically converted to an issue within the repository. In the project board, the new issue card will be in the same location as the previous note.
Editing and removing a note
- Navigate to the note that you want to edit or remove.
- Click the dropdown.
3) Click Edit note to edit the contents of the note.
4) Click Delete note to delete the note from the Project.
Closing a project board
On GitHub, navigate to the main page of the repository.
Under your repository name, click Projects.
In the projects list, next to the project board you want to close, click the dropdown.
Click Close.
Deleting a project board
On GitHub, navigate to the main page of the repository.
Under your repository name, click Projects.
In the projects list, next to the project board you want to delete, click dropdown, then click Edit.
At the bottom of the page, click Delete project.
4) To confirm that you want to delete the project board, click OK.