Milestones project management guidelines

1. You are here:
2. Marketing
3. Marketing Project Management Guidelines
4. Milestones project management guidelines

On this page

• Background
  • Key things to know
  • Known limitations
• Guidelines
  • Define milestone at lowest level needed
  • Milestone Naming Convention - prefix in name
  • Milestone Dates & Duration - It depends, though shorter is often better
  • Milestone Description - Include milestone history and who owns

This is a work in progress for the Marketing Project Management Simplification project.

Background

Milestones are a great way to track the progress of multiple related issues across a specific time period. With milestones, you can see how fast issues are being completed in that time period (burndown chart), and you can view the issues grouped by labels, and grouped by status (unassigned, assigned, and completed)

Milestones are very useful when tracking the progress of multiple issues and when planning and managing epics.

Here are two examples of milestones:

1. Strategic Marketing Quarterly Milestone - showing the bulk of strategic marketing work for a given quarter.
2. UseCase Monthly Sprint Milestone

Key things to know

1. Milestones can be created at both Project and Group levels.
2. Milestones can be used to establish dates for epics (where the epic inherits the dates from the issues and associated milestones)
3. Milestones set a date range (start date and end date)
4. Issues are added to milestones
5. Milestone lists can be sorted only by name and date (either due date or start date)

Known limitations

1. Milestone lists cannot be filtered and have limited sorting
2. Milestones do not have labels and cannot be filtered by labels
3. Milestones do not track history of changes or who created/changed the milestone
4. On issues - when adding an issue to a milestone, the list of milestones is ALL of the milestones in that project and the parent groups (potentially LOTS AND LOTS of milestones)
5. On groups - the list of milestones is ALL of the milestones defined in that group and below that group (potentially LOTS AND LOTS of milestones) - This feature request addresses this limitation.
6. On Projects - the list of milestones is ONLY the milestones defined in that project (deceptively very few milestones.) see feature request

Guidelines

Define milestone at lowest level needed

Define milestones at the LOWEST level of the organization as possible.

• If the milestone ONLY applies to a specific project, then create the milestone there
• If the milestone applies to a group of projects, then create the milestone at the lowest possible group.

This will mean that the lists of milestones available to a given Issue (when adding an issue to a milestone) will be limited to a smaller list of relevant milestones. (though the list might still be very long)

Milestone Naming Convention - prefix in name

Because of the filtering limitations and the massive volume of potential milestones, a consistent Naming Convention is very, very, very helpful in finding the right milestones.

• All Milestone names should start with either the group or project abbreviation. The recommendation is to prepend the name with a two-letter abbreviation followed by underscore: gg_.

For example:

• A project milestone in the "Field Marketing" project should be named:
  • **fm_**Milestone Name
• A group milestone in the "Strategic Marketing" group should be named:
  • **sm_**Milestone Name

This will help in two ways. First, when looking at lists of milestones, they can be sorted and put the related milestones together. Second, in issues, when adding a milestone, you can search by name, which will make it easy to find the right subset of milestones (either for the project or group)

Milestone Dates & Duration - It depends, though shorter is often better

Because the milestone has dates for start and finish, the implication is that issues and MRs in the milestone are completed in this time window. If the milestone window is 3 weeks, then the expectation is that the work in the milestone is completed in that time frame.

Every team and every project is unique and there is no ONE answer for milestone duration. Some teams have had milestones as long as a quarter, others 4 weeks and others 1 week. Choose the duration that works for your team, learn, and evolve.

Milestone Description - Include milestone history and who owns

Because the milestone does not yet include change history or details about who created it or why, we should use the description field to fill in the blanks.

• In the description field describe the purpose of the milestone and who is milestone owner/manager