Skip to content

Draft: Rename Strategic/Portfolio Marketing to Product Marketing and Brand in the marketing handbook

Why is this change being made?

Product Marketing was renamed to Strategic Marketing and later renamed Product Marketing again in the past 2 years, and Portfolio Marketing was a term too. The URL still reflects /strategic-marketing for Product Marketing for example.

Some other places in the marketing handbook use Portfolio Marketing and link to /strategic-marketing, which can be confusing to follow.

This MR does the following:

  1. Rename the directory and URL to /handbook/marketing/product-marketing
  2. Add redirects from /strategic-marketing/ to /product-marketing/ in data/redirects.yaml
  3. Rename Strategic|Portfolio Marketing as a term in the handbook
  4. Remove the strategic marketing Slack channel in /handbook/marketing
  5. Update .gitlab/CODEOWNERS to point to the correct path
  6. Keep the gitlab-com subgroups to gitlab-com/marketing/strategic-marketing and gitlab-com/marketing/strategic-marketing/product-marketing

Additionally (approved in Slack by @akramer and @dsteer)

  1. Rename Product Marketing to Product Marketing and Brand
  2. Ensure that Product Marketing Manager as a job family stays intact

Technical details

All commands on the CLI, and some editor parts for data/redirects.yaml and .gitlab/CODEOWNER replacements.

vim data/redirects.yml

:%s/strategic-marketing/product-marketing/g

:wq 

vim .gitlab/CODEOWNERS

# mark a section
shift+v

: s/strategic-marketing/product-marketing/g

:wq
git mv marketing/strategic-marketing marketing/product-marketing

# replace all target URLs

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,/strategic-marketing,/product-marketing,g" {}' \;

# replace all text terms 

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,Strategic Marketing,Product Marketing,g" {}' \;

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,Strategic marketing,Product marketing,g" {}' \;

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,strategic marketing,product marketing,g" {}' \;

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,Portfolio Marketing,Product Marketing,g" {}' \;

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,Portfolio marketing,Product marketing,g" {}' \; 

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,portfolio marketing,product marketing,g" {}' \;

After consolidating to Product Marketing, adding approved changes to Product Marketing and Brand into URLs and text changes. It is now shorter just replacing one term. The full diff will show the merged changes.

git mv marketing/product-marketing marketing/product-marketing-and-brand

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,/product-marketing,/product-marketing-and-brand,g" {}' \;

find . -type f -name '*.md*' -exec sh -c 'sed -i -e "s,Product Marketing,Product Marketing and Brand,g" -e "s,Product marketing,Product marketing and brand,g" -e "s,product marketing,product marketing and brand,g" {}' \;

Requires reverts of a few locations where Product Marketing Manager needs to stay intact.

find . -type f -name '*.md*' -exec sh -c 'sed -i "s,Product Marketing and Brand Manager,Product Marketing Manager,g" {}' \;
vim data/redirects.yml

:%s/product-marketing/product-marketing-and-brand/g

:wq 

vim .gitlab/CODEOWNERS

# mark a section
shift+v

: s/product-marketing/product-marketing-and-brand/g

:wq

Revert the gitlab-com subgroup changes.

find sites/handbook/source/handbook -type f -name '*.md*' -exec sh -c 'sed -i "s,gitlab-com/marketing/product-marketing-and-brand,gitlab-com/marketing/strategic-marketing,g" {}' \;

find sites/handbook/source/handbook -type f -name '*.md*' -exec sh -c 'sed -i "s,gitlab-com/marketing/strategic-marketing/product-marketing-and-brand,gitlab-com/marketing/strategic-marketing/product-marketing,g" {}' \;

Author Checklist

  • Provided a concise title for this Merge Request (MR)
  • Added a description to this MR explaining the reasons for the proposed change, per say why, not just what
    • Copy/paste the Slack conversation to document it for later, or upload screenshots. Verify that no confidential data is added.
  • Assign reviewers for this MR to the correct Directly Responsible Individual/s (DRI)
    • If the DRI for the page/s being updated isn’t immediately clear, then assign it to one of the people listed in the Maintained by section on the page being edited
    • If your manager does not have merge rights, please ask someone to merge it AFTER it has been approved by your manager in #mr-buddies
  • If the changes affect team members, or warrant an announcement in another way, please consider posting an update in #whats-happening-at-gitlab linking to this MR
    • If this is a change that directly impacts the majority of global team members, it should be a candidate for #company-fyi. Please work with internal communications and check the handbook for examples.

Edited by Michael Friedrich

Merge request reports