39

How do I close/complete milestones on GitHub projects? I've already three milestones that are "overdue" but they are completed already. I simply don't know how to mark them "completed" - can anyone help me?

I already tried to Google this issue, and browsed the GitHub help pages, but couldn't find any information on using milestones.

TylerH
  • 20,799
  • 66
  • 75
  • 101
q9f
  • 11,293
  • 8
  • 57
  • 96

3 Answers3

27

Update: this is an old answer for an old question. The nowerdays correct answer is the one by seeker.

Milestones now must be closed manually. --- A.J. Brown

Simply creating and closing an issue for a milestone, will mark the milestone completed:

When all issues of the milestone are closed, the milestone should be closed as well.

--- Felix King

Thanks.

Boiethios
  • 38,438
  • 19
  • 134
  • 183
q9f
  • 11,293
  • 8
  • 57
  • 96
  • 6
    This used to happen reliably, but isn't happening for me anymore. Any clues? Milestone shows 100% completed – ncatnow Jul 01 '13 at 05:08
  • What's wrong? With the new Github layout a milestone still completes when all issues related to the milestone are closed/fixed. – q9f Jul 01 '13 at 05:50
  • 2
    The only thing wrong is that the milestone no longer closes for me, I need to go and close it manually. Seems to have started around the time of the new layout. – ncatnow Jul 02 '13 at 07:01
  • You need to connect the issues to the milestone. It's working here. Anyways, there is a `close` button now for milestones. – q9f Jul 02 '13 at 16:35
  • 4
    I don't see how I've been unclear. Whereas milestones used to close when the last issue in the milestone was closed, now, even when I close the last open issue in the milestone, the milestone remains open, and I have to close it manually. Notice the '100% completed' in my first comment. – ncatnow Jul 05 '13 at 07:30
16

One way of interpreting the GitHub blog post Simpler Milestone Workflow is that Milestone state change via issues was disabled with the update on June 18, 2013:

Milestones will no longer change state based on any sort of issue assignment.

Edit: I contacted GitHub support regarding this, and they confirmed that it is indeed the intended behaviour.

seeker
  • 671
  • 7
  • 13
14

Milestones are only closed manually. You can close a milestone by clicking the "close" link in the list of milestones. Note that for some reason, there is no "close" button in the milestone's details page, only in the list page of milestones.

Screenshot

Flimm
  • 136,138
  • 45
  • 251
  • 267
  • 3
    For those wondering how to get to this page in the first place, it's "Issues" or "Pull Requests". – Abhijit Sarkar Aug 05 '20 at 07:01
  • For those who are just beginning and who wonder how to get the milestone to 100 % or whatever percentage: create issues and assign them to an existing milestone. As soon as you close an issue, its share in the total number of issues of that milestone will be shown by the green bar. – questionto42 May 28 '21 at 21:18