{"id":1935,"date":"2024-08-10T02:42:19","date_gmt":"2024-08-10T06:42:19","guid":{"rendered":"http:\/\/sites.bu.edu\/marcom-team\/?page_id=1935"},"modified":"2025-09-03T17:00:58","modified_gmt":"2025-09-03T21:00:58","slug":"adding-milestones-projects","status":"publish","type":"page","link":"https:\/\/sites.bu.edu\/marcom-team\/departments\/interactive-design\/github-smartsheets\/adding-milestones-projects\/","title":{"rendered":"Adding Milestones &#038; GitHub Projects"},"content":{"rendered":"<h5><strong>Table of Contents<\/strong><\/h5>\n<ol>\n<li>Introduction<\/li>\n<li>Set up milestones in GitHub<\/li>\n<li>Set up project board in GitHub\n<ul>\n<li>Current Sprint board<\/li>\n<\/ul>\n<\/li>\n<li>Next section: GitHub &amp; Smartsheet Workflow<\/li>\n<\/ol>\n<h2>Introduction<\/h2>\n<p>This section of the documentation will show you how to set up a project in GitHub.<\/p>\n<h2>Set Up Milestones in GitHub<\/h2>\n<p>Milestones help organize issues by release, and help track progress towards a feature being ready for the client. They also allow you to see at a glance all of the issues that are open or closed in that milestone. You can find Milestones under Issues &gt; Milestones, or <a href=\"https:\/\/github.com\/bu-ist\/id-github-demo\/milestones\">see a demo on the ID GitHub repo<\/a>.<\/p>\n<p><img loading=\"lazy\" src=\"\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-636x448.png\" alt=\"\" width=\"636\" height=\"448\" class=\"alignnone size-medium wp-image-1927\" srcset=\"https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-636x448.png 636w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-150x105.png 150w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-768x541.png 768w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1024x722.png 1024w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1.png 1536w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-382x270.png 382w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-709x500.png 709w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-500x352.png 500w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-585x413.png 585w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-885x624.png 885w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-957x675.png 957w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-791x558.png 791w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1197x844.png 1197w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1531x1080.png 1531w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-600x423.png 600w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-496x349.png 496w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-750x528.png 750w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1000x705.png 1000w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1171x826.png 1171w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1418x1000.png 1418w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-992x699.png 992w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1200x846.png 1200w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-1500x1057.png 1500w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-550x387.png 550w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-710x500.png 710w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-400x282.png 400w, https:\/\/sites.bu.edu\/marcom-team\/files\/2024\/08\/Screen-Shot-2022-06-22-at-5.23.20-PM-1536x1083-1-300x211.png 300w\" sizes=\"(max-width: 636px) 100vw, 636px\" \/><\/p>\n<ul>\n<li aria-level=\"1\">The ACD should set up Milestones for each planned release and assign issues in that release to the milestone (referenced in GitHub Responsibilities section below).<\/li>\n<li aria-level=\"1\">Don\u2019t enter a date. All dates will be in the project schedule in Smartsheets.<\/li>\n<li aria-level=\"1\">Additional Milestones can be used at the team\u2019s discretion for tracking milestones such as prelaunch bugs, post launch bugs, etc.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>Set Up Project Board in GitHub<\/h2>\n<p>At the start of the project create a project on the bu-ist github account: https:\/\/github.com\/orgs\/bu-ist\/projects. These projects will use the new Github Projects that are global to our Github Organization.<\/p>\n<h4><strong>Project Name Structure<\/strong><\/h4>\n<ul>\n<li>ID: Project Name YYYY or ID: Project Name YYYY-YYYY<\/li>\n<li>ID Product: Project Name<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h4>Create Custom Fields for:<\/h4>\n<ul>\n<li>FE Hours (number field)<\/li>\n<li>BE Hours (number field)<\/li>\n<li>% FE Complete (number field)<\/li>\n<li>% BE Complete (number field)<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>Create Views of the Following:<\/h2>\n<h4>Current Sprint View<\/h4>\n<ul>\n<li><strong>Layout:<\/strong> Board<\/li>\n<li><strong>Name:<\/strong> Current Sprint<\/li>\n<li><strong>Visible Fields:\u00a0<\/strong>\n<ul>\n<li>Labels<\/li>\n<li>Assignees<\/li>\n<li>Hours (custom field)<\/li>\n<li>Milestone (to show Releases)<\/li>\n<li>FE Hours<\/li>\n<li>BE Hours<\/li>\n<li>Status<\/li>\n<\/ul>\n<\/li>\n<li><strong>Sort:<\/strong> Manual<\/li>\n<li><strong>Column by:<\/strong> Status<\/li>\n<li><strong>Field Sums:<\/strong> FE Hours, BE Hours, and Count to show the amount of work in each status<\/li>\n<\/ul>\n<p>A <em>single<\/em> sprint view should be created to track progress towards a release within each 2 week (or other timeframe) sprint. The ToDo column should only have issues directly related to the current sprint on it (and any work remaining from the previous sprint), and be managed by the entire team in a <em>sprint planning meeting<\/em> at the start of each sprint. During that meeting the previous sprint progress would be reviewed, and new issues added for the next sprint. The issues added to the ToDo column for that sprint should equal or less than amount of time available in that sprint for each resource.<\/p>\n<ul>\n<li aria-level=\"3\">This board is not automated<\/li>\n<li aria-level=\"3\">Columns on this Board:\n<ul>\n<li aria-level=\"4\"><strong>No Status<\/strong> &#8211; these are all of the issues added to the Github Project but are not in the current sprint. This is not quite a backlog as it will include completed items.<\/li>\n<li><strong>On Deck<\/strong> &#8211; A column to add cards for upcoming sprints to. In a sprint planning meeting, groom issues for the following sprint and add them to this column.<\/li>\n<li aria-level=\"4\"><strong>To Do<\/strong> &#8211; the items groomed and planned to be completed this sprint. <em>Add the Dates of the Current Sprint to the description field for this column and update at the start of each sprint.<\/em><\/li>\n<li aria-level=\"4\"><strong>In Progress<\/strong> (denote roles involved by label and by assignments to users)<\/li>\n<li aria-level=\"4\"><strong>Blocked<\/strong> &#8211; tasks in this project that cannot be completed at this moment<\/li>\n<li aria-level=\"4\"><strong>In Review<\/strong> &#8211; code and\/or functional review<\/li>\n<li aria-level=\"4\"><strong>Done<\/strong> &#8211; work is complete for the effort needed in this sprint, but not necessarily release ready or feature complete<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h4>All Issues View<\/h4>\n<ul>\n<li><strong>Layout:<\/strong> Table<\/li>\n<li><strong>Name:<\/strong> All Issues<\/li>\n<li><strong>Visible Fields:\u00a0<\/strong>\n<ul>\n<li>Labels<\/li>\n<li>Assignees<\/li>\n<li>Hours (custom field)<\/li>\n<li>FE Hours<\/li>\n<li>BE Hours<\/li>\n<li>% FE Hours Complete<\/li>\n<li>% BE Hours Complete<\/li>\n<li>Status<\/li>\n<li>Milestone (to allow assigning issues to releases quickly)<\/li>\n<\/ul>\n<\/li>\n<li><strong>Sort:<\/strong> Title<\/li>\n<li><strong>Group by:<\/strong> None<\/li>\n<\/ul>\n<p>This view should be created to show all the issues assigned to the project. It is useful for rapid entry of hours, percentages complete, assigning of milestones early in the setup of a project and for ensuring all issues have appropriate labels and other data assigned to the issue.<\/p>\n<p>&nbsp;<\/p>\n<h4>All Releases View<\/h4>\n<ul>\n<li><strong>Layout:<\/strong> Table<\/li>\n<li><strong>Name:<\/strong> All Issues<\/li>\n<li><strong>Visible Fields:\u00a0<\/strong>\n<ul>\n<li>Labels<\/li>\n<li>Assignees<\/li>\n<li>Hours (custom field)<\/li>\n<li>FE Hours<\/li>\n<li>BE Hours<\/li>\n<li>% FE Hours Complete<\/li>\n<li>% BE Hours Complete<\/li>\n<li>Status<\/li>\n<\/ul>\n<\/li>\n<li><strong>Sort:<\/strong> Manual (by priority or other agreed upon order)<\/li>\n<li><strong>Group by:<\/strong> Milestone<\/li>\n<li><strong>Field Sums:<\/strong> FE Hours, BE Hours, and Count to show the amount of work in each status<\/li>\n<\/ul>\n<p>This view should be created to show all the issues assigned to the project, <strong>but grouped by Releases<\/strong>. This view allows everyone to see all of the issues needed to be completed for each release, as well as any issues that are not assigned to a release. This view should be created early in the project and shared with the project manger to aid in creation of the project schedule. Issues should only be added or removed to a release milestone by the ACD or during sprint planning meetings.<\/p>\n<p>Additional views can be created as needed, however the team must ensure they are reviewing and planning the issues they are completing based on the information in these three views.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Table of Contents Introduction Set up milestones in GitHub Set up project board in GitHub Current Sprint board Next section: GitHub &amp; Smartsheet Workflow Introduction This section of the documentation will show you how to set up a project in GitHub. Set Up Milestones in GitHub Milestones help organize issues by release, and help track [&hellip;]<\/p>\n","protected":false},"author":12906,"featured_media":0,"parent":1856,"menu_order":9,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/1935"}],"collection":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/users\/12906"}],"replies":[{"embeddable":true,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/comments?post=1935"}],"version-history":[{"count":7,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/1935\/revisions"}],"predecessor-version":[{"id":2849,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/1935\/revisions\/2849"}],"up":[{"embeddable":true,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/1856"}],"wp:attachment":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/media?parent=1935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}