Skip to content

Update deprecation details for TW Lead in handbook and RP MR template

Marcel Amirault requested to merge update-deprecation-details into master

Why is this change being made?

Related to: Product#2864 (closed)

After multiple discussions and MRs from multiple authors, I think some details got a bit out of sync with the latest process, or at least needed to be clarified.

This MR attempts to solidify the deprecations process based on my current understanding of the process, in an effort to make it much easier to anyone new to the process to do it. Both for PMs and TWs.

This is a full TW copy edit of the process, including:

  • Adding ordered lists of steps, to make it clear what is general information, and what are steps to follow.
    • Creating the deprecation yaml is now an ordered list.
    • Updating the deprecations doc was already a list, but it's updated.
  • Simplify and clarify the language.
  • Add crosslinks throughout.

Key sections to check in the review app:

Related issues and MRs

Author Checklist

  • Provided a concise title for the 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 change to the correct DRI(s)
    • 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 in 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 Farnoosh Seifoddini

Merge request reports