Jira vs GitHub terminology
- Kyle McCormick
The gist
Jira:
projects contain:
issues; and
boards, which show subsets of the project’s issues.
GitHub:
repositories contain:
issues.
projects contain:
cards, each of which points to an issue; and
boards, which show a subset of the project’s cards.
Details
Jira term | Closest GitHub term |
|---|---|
Project A project is a sequential list of issues. Projects can configure rules about their issues. Example Project: TNL | Repository A version-controlled codebase, containing a sequential list of issues. Repositories can configure rules about their issues. Example Repo: credentials |
Project A task-management tool. Independent of repos. Permissions are managed at the GH organization level. Projects can configure rules about their cards. Each card in a project cards can point to an issue from any repository in any organization. Example Project: Open edX Roadmap | |
Issue An issue can have:
Example Issue: TNL-1234 | Issue An issue can have:
Example Issue: credentials#1736 |
Pull Request A pull request is a special type of issue that contains a code change and allows code review & merging. It can be treated just like a normal issue for the purpose of GitHub Projects. | |
Card A card is an item on project. It can have:
A draft card is converted to a proper card by choosing a repository, which creates an issue in that repository. The title, description, discussion and assignees from the draft are transferred to the new issue. Multiple cards can point to the same issue. Specifically, there is a card for every project than issue has been added to. Example Card: credentials#1736 on the Open edX Roadmap | |
Board A board is a filtered view of a project, showing a subset of the project’s issues. Issues can be added from other projects (I think?). Every project has a default board, configured in project setings. | Board A board is a filtered view of a project, showing a subset of the project’s cards. Both Kanban and Table views are available. Cards from other projects cannot be shown. Example Board: the Credentials tab of the Open edX roadmap Every project has a default board: it’s one under the leftmost tab. |