Marketing Project Management Guidelines

Sub Pages

  1. Organization - Groups and Projects
  2. Labels
  3. Epics
  4. Milestones
  5. Managing Commitment
  6. Issues
  7. Boards

Marketing Project Management Guidelines

Marketing uses GitLab for agile project management including groups, projects, epics, roadmaps, issues, labels, and boards. Read through the documentation on each of these GitLab features if you are unfamiliar.

Integrated Campaigns

Marketing Departments collaborate to produce Integrated Campaigns. An Integrated Campaign is a communication effort that includes several campaign tactics such as blog posts, emails, events, advertisements, content on about.gitlab.com, videos, case studies, whitepapers, surveys, social outreach, and webcasts. An Integrated Campaign will have a campaign theme that summarizes the message we are communicating to our market.

Active integrated campaigns

Active integrated campaigns

Have a new campaign idea? Make a suggestion

Project Management Processes

We cultivate a deep understanding of our own product by using GitLab to manage our planning, collaboration, and execution of Marketing activities.

The latest Project Management recommendations can be found here from FY21-Q2 Agility Project

Milestones

The latest recommendations for Milestones from FY21-Q2 Agility Project

Weekly Sprints

Within the www-gitlab-com repo (parent repo to Marketing) there are weekly milestones, which some teams use plan a weekly sprint cadence. Each of these sprints begins with “Fri:**” for the Friday upon which that sprint ends, making them searchable in a list here.

Each week on Monday, any open MRs and issues still assigned to the previous week’s milestone are bulk moved forward to the next week, and the previous milestone is closed out. This is a manual process currently performed by Danielle.

Groups and projects

The latest recommendations for Groups and Projects from FY21-Q2 Agility Project

  1. The Marketing Group houses all marketing projects.
  2. Labels should be created at the group level so they can be used in all projects within Marketing group.
    • Labels should not be duplicated in individual projects. It creates board/tracking conflicts.
  3. The following are the approved marketing projects, CMO approval is needed to begin a new project.
  4. Issues should be logged in the team project ultimately responsible for completing requested work. (i.e. If SDR needs list uploaded -> issue created in Marketing Operations project).

Issues, Milestones, and Epics

The latest recommendations for Epics and the latest for Issues from FY21-Q2 Agility Project

  1. Each issue represents a discrete unit of work with a deliverable. For example 1 2 3
  2. Every MR should have an issue so that it can be tracked on issue boards.
  3. Milestones represent units of work to be completed within a specific time frame, sometimes referred to as sprints. They are comprised of multiple issues that share a common due date, and help break large projects into more manageable parts.
  4. Epics represent projects that comprise multiple issues. (Don’t use “meta” issues for this purpose. If you have an existing meta issue you can promote them to epics using the /promote quick command.)
    • Epics live at the group level (e.g. issue from multiple marketing projects can be added to an epic.)
    • Epics are labeled with a group label of the team that owns the epic.
  5. The top 3-5 strategic initiatives are tracked in epics using the CMO label. (Don’t apply the CMO label to other epics.)
  6. Roadmaps are used for time-based display of epics with a start and end date. (for example, events and time-based campaigns.)

Boards and Labels

The latest recommendations for Labels and the latest for boards from FY21-Q2 Agility Project

  1. Each team has one or more boards to track ongoing workstreams.
  2. Generally, create a board for each function. (For example PMM has boards for Sales Enablement, Analyst Relations, Customer Relations, etc.)
  3. Each board uses a standard set of columns/labels so that folks can easily understand what is happening on another teams board.
  4. The board labels use group scoped labels with mktg-status:: and one of four statuses. Status labels should be used on all issues within the Marketing group:
    • mktg-status::plan - work that is proposed, in an exploratory state.
      • To exit the plan stage the work must be assigned to a DRI.
      • DRI accepts responsibility for the task by changing the label from mktg-status::plan to mktg-status::wip and creating an merge request (MR), if appropriate. The plan status is optional, as issues that don’t require formal planning can be opened and labeled mktg-status::wip.
    • mktg-status::wip - work in progress that has been accepted and assigned to a DRI.
      • Work in this stage should not be merged.
      • Merge requests (MRs) should be prepended with WIP:. At GitLab we allow reviewers to start reviewing right away before work is complete.
      • Use MVCs: At any time, if the work is complete enough that merging would be better than what current exist the issue should be labeled with mktg-status::review and WIP: should be removed from the title.
    • Optional*: mktg-status::review - work has been completed enough that it is ready for formal review and approval.
      • Work that is approved can be either merged or scheduled.
      • The review status is optional.
      • Work that doesn’t require review can simply be merged/closed.
    • Optional: mktg-status::scheduled - work that is complete but should be scheduled for a future date.
      • Scheduled status is optional as not all work will need to be scheduled.
    • closed - when work is delivered the issue should be closed.
  5. Don’t duplicate status labels at the project level. Use group labels (at the Marketing Group level) as much as possible.

Department Labels

Each Department within Marketing can have “additive” labels - meaning they are used to enhance the tracking and workflows for that respective team. These “additive” labels are used in conjunction with the broader Marketing labels. The Department label usage is documented on each of the respective handbook pages:

Default Issue Text

All of the projects within the Marketing subgroup include default issue text to ensure the Department labels are applied consistently and broader adoption of the global Marketing labels.

Using Default Issue Text

When a new issue is opened in any project, the issue description will contain a small snippet of text applying that teams’ label & Marketing scoped mktg-status::plan label.

’’

  • If a template is chosen, a message will appear confirming you want to change the text w/in the issue description, click Apply Template and continue as normal

’’

Updating Default Issue Text

The default text is minimal and generic. Any team can make the collective decision to update the text. Access to modify the text may be limited based on group/project permission level, if you do not have access to the General settings section, please reach out to @mktg-ops via slack. Please note this is not an issue bot there is no dynamic functionality. The default issue text applies to all issues opened within that project and the text should be broad enough to encompass a roles within that team.

  1. Navigate to project to be updated
  2. Left side menu, hover over the wheel widget (last icon) -> Select General
  3. Scroll down & select Expand next to Default Issue Template
  4. In the text box you can add any markdown formatting & modify the text. The text that has been added included several lines above it, so it may appear to be a blank box. Scroll down &/or expand that text box to see complete text.
    • Please do not delete the labels section.
    • Label section can be updated to include more labels &/or switch the Department label
    • Important to leave the mktg-status::plan label in that section
  5. Once edits have been made, click Save changes. The changes be applied immediately to any new issue opened.
    • Does not affect already opened issues.

If you have any issues &/or questions, please reach out to the MktgOps team (@mktg-ops) via slack.

How it all fits together

Figuring out how where and how to create a board, epic, label can be confusing. The following diagram is a very high level example of how it all fits together. If there are questions please ask in the #mktgops slack channel (*must be GitLab team member for active link).


Epics project management guidelines
This is a work in progress for the Marketing Project Management Simplification project. Background …
Issue and Kanban boards project management guidelines
This is a work in progress for the Marketing Project Management Simplification project. Background …
Issues project management guidelines
This is a work in progress for the Marketing Project Management Simplification project. Background …
Labels project management guidelines
This is a work in progress for the Marketing Project Management Simplification project. Background …
Managing Commitment
This is a work in progress for the Marketing Project Management Simplification project. Background …
Marketing Groups and Projects guidelines
This is a work in progress for the Marketing Project Management Simplification project. Background …
Milestones project management guidelines
This is a work in progress for the Marketing Project Management Simplification project. Background …
Last modified March 5, 2025: Fix broken links (2feb413c)