GitHub Projects

GitHub Projects provided a free alternative to project tracking solutions such as Jira, Rally, and Trello. Each project is represented by a board with multiple columns that contain cards.

cover

There are three kinds of project boards:

User-owned and organization-wide project boards can see issues in linked repositories and can drag them onto the board to turn them into cards. The GitHub page for linked repositories doesn't provide access to the project boards in which they are linked.

To create a repository project:

  1. Browse a repository.
  2. Click the "Projects" tab.
  3. Press the "New project" button.
  4. Enter a project board name.
  5. Optionally enter a project description.
  6. Optionally select a project template such as "Basic kanban".
  7. Press the "Create project" button.

To create a user project, browse github.com/{username} instead of a specific repository and then follow the same steps as above.

The "Basic kanban" project template provides three columns named "To do", "In progress", and "Done" with a few sample cards already in the "To do" column.

To add a column, click "+ Add column" to the right of the last column.

To delete a card, click the ellipsis in its upper-right and select "Delete note".

To add a card in a column, click the "+" in the upper-right of the column.

To edit a card, click the ellipsis in the upper-right of the card and select "Edit note". A dialog will open where changes can be made.

To move a card to a different column, drag it.

To link a repository to a user project so it is shared by them:

  1. Click the "Projects" tab.
  2. Click a user project name.
  3. Click the "X" in the upper-right of the card search pane to close it.
  4. Click "Menu" in the upper-right.
  5. Click the ellipsis in the upper-right.
  6. Click "Settings" in the drop-down.
  7. Click "Linked repositories".
  8. Press the "Link a repository" button.
  9. Enter part of a repository name to get a filtered list.
  10. Click a repository name.
  11. Click the "Link" button.
  12. Repeat to link additional repositories.

TODO: Why can't you see the user project from the linked repositories?