GitHub Projects

One list of work, seen as a table, a board or a roadmap

TABLELogin pageDoneSearchIn progressExport CSVIn progressDark modeTodoBOARDTodoDark modeIn progressSearchExport CSVDoneLogin pageROADMAPweek 1week 2week 3week 4Login pageSearchExport CSVDark modeA project is one list of items. Each view lays the same items out differently.A table is a spreadsheet. A board shows cards in columns, to drag between stages. A roadmapplaces items on a timeline. Changing an item in one view changes it in all of them.

The same items as a table, a board or a roadmap.

GitHub Projects · Going deeper

About Projects

About ProjectsItemsIssues, pull requests and draft issuesReachItems can come from many repositoriesOwnerA personal account or an organization, not a repositoryViewsSaved combinations of layout, filter, sort, group and sliceVisibilityPrivate by default; can be made publicStatus updatesMark the project on track, at risk or off track, with a noteTemplatesAn organization can save a project as a template to copyA project tracks work. The issues and pull requests stay in their repositories.Editing an issue in the project edits the real issue, and the other way round.

Items from many repositories, owned by a person or organization.

Fields

The project adds its own fields to every item

THE ISSUE, IN ITS REPOSITORYSearch #18AssigneesmonaLabelsfeatureMilestonev2.0FIELDS THE PROJECT ADDSStatusIn progresssingle selectPriorityHighsingle selectSprintSprint 4iterationEstimate5numberTarget date12 DecdateCustom fields belong to the project, so one issue can carry your team's own data.An issue brings its assignees, labels and milestone. The project adds fields of five types: text,number, date, single select and iteration. You can then sort, group and filter by any of them,for example grouping a board by Priority.

The issue brings labels and assignees. The project adds custom fields.

Fields · Going deeper

Field types

Field typeHoldsTypical useTextFree textA note, a customer nameNumberA numberAn estimate, summed per groupDateA calendar dateStart and target dates on a roadmapSingle selectOne option from a listStatus, priority, teamIterationA repeating time boxSprints, with breaksBuilt-inAssignees, labels, milestone, repositoryCarried from the issue or pull requestParent issueThe issue this one is a sub-issue ofProgress of sub-issuesStatus is a single select field. Its options are the columns of a board.Filter a view by typing, for example status:"In progress" assignee:@me.

Text, number, date, single select, iteration.

Check yourself

TodoDark modeIn progressSearchExport CSVDoneLogin page

Which layout is this view using?

Workflows

Built-in workflows update the project for you

WHENTHEN, WITH NOBODY CLICKINGAn item is added to the projectStatus becomes TodoAn issue is closedStatus becomes DoneA pull request is mergedStatus becomes DoneA new issue has the label bugIt is added to the projectBuilt-in workflows keep the project up to date as the work happens.You switch them on in the project's Workflows menu, with no code. Two are on by default:closing an issue and merging a pull request both set Status to Done. Auto-add brings in newitems from a repository when they match a filter.

Built-in workflows set Status when items are added, closed or merged.

Workflows · Going deeper

Ways to automate a project

Way to automateWhat it doesBuilt-in workflowsSet a field when an item is added, closed, reopened or mergedAuto-addAdd new items from a repository that match a filterAuto-archiveArchive items that match a filter, such as closed long agoGitHub ActionsCustom rules, such as adding a pull request when it is ready for reviewGraphQL APIRead and change projects from your own scripts and toolsStart with the built-in workflows. Reach for Actions or the API only when they are not enough.Archived items leave the views but are not deleted, and can be restored.

Auto-add, auto-archive, Actions and the API.

Labels, assignees, milestones

What kind, who, and by when

LABELS: WHAT KINDbugdocumentationgood first issueASSIGNEES: WHOmonaresponsible for itup to 10 peopleon one issue or pull requestMILESTONE: BY WHENv2.0due 12 Dec6 of 8 closed: 75% completeLabels say what kind of work it is, assignees say who, and a milestone says by when.All three belong to a repository and work with or without a project. A milestone groups issuesand pull requests toward a goal, with an optional due date, and shows how much is closed.

Labels categorize, assignees own, a milestone tracks progress to a date.

Labels, assignees, milestones · Going deeper

More ways to organize

ToolWhat it is forLabelsCategorize; a new repository starts with nine, and you can add your ownAssigneesShow who is working on it; up to 10 per issue or pull requestMilestonesTrack progress toward a release or a dateIssue typesAn organization's own kinds, such as Bug, Task, FeatureSub-issuesBreak a large issue into smaller ones, with progressSaved repliesYour own reusable comments, inserted with two clicksTemplatesGive new issues and pull requests a ready-made structureSaved replies are personal: they belong to your account, not to a repository.Issue and pull request templates belong to the repository, in the .github folder.

Issue types, sub-issues, saved replies and templates.

Check yourself

v3.1due 30 Jan9 of 12 issues and pull requests closed

Which feature shows this?

Insights

Charts drawn from the project itself

CURRENT CHART: ITEMS BY STATUS, TODAYTodo6In progress4Done10HISTORICAL CHART: BURN UP, OVER FIVE WEEKSall items: 20completed: 10w1w2w3w4w5Insights turns the project's items into charts, with no export.A current chart counts items as they are now, such as how many per status or per assignee.A historical chart shows change over time. The default one, Burn up, compares completed workwith the total, so you can see whether the scope is growing faster than the work is done.

Current charts count items now. Historical charts show change over time.

Insights · Going deeper

Clue words for managing projects

When the question saysThe answer isRemember"spreadsheet view of issues"Table layoutsort, group, bulk edit"cards in columns, drag between stages"Board layoutcolumns from Status"items on a timeline"Roadmap layoutneeds date or iteration fields"track priority, estimate or sprint"Custom fieldsfive types"set Status to Done when closed"Built-in workflowno code"add new issues to the project by itself"Auto-add workflowmatches a filter"charts of the project's progress"Insightscurrent and historical"categorize issues: bug, documentation"Labelsper repository"group issues toward a release date"Milestoneshows % complete"who is responsible for the issue"Assigneeup to 10"reuse the same comment often"Saved replypersonalDomain 5 is 5 to 10% of the exam.

Board, workflow, insights, milestone and saved reply.

Check yourself

Whena pull request in the project is mergedThenits Status field changes to DoneBy whomnobody: it happened by itself, with no code written

Which feature did this?

Lesson complete

You finished “Managing projects”

Answer the questions along the way to see your score here.

Open in a new tab