Transition Developer Experience/API group to Isaac Durham
- Stage/group being transitioned: devopsdeveloper experience / ~"group::api"
- Current technical writer: #docs channel
- Incoming technical writer: @idurham
- Reassignment milestone: %18.8
Tasks for EMs and PMs
-
Add the incoming TW to team meetings and any group aliases.
- Meeting list: TBD
- Group aliases: TBD
-
Async retrospectives (if applicable):
- Update teams.yml.
- If the retrospective happens in a private project, add the TW to it.
- Remove the outgoing TW from team meetings and any group aliases.
- Determine the resources needed by the incoming TW to learn the stage / group features, similar to an engineer's onboarding.
Tasks for incoming technical writer
-
Set up coffee chats with the group's:
- Product manager
- Engineering manager @amyphillips
- Frontend and backend team members (not necessary to meet all)
- UX designer
- Read the product documentation associated with your group (as identified by the group attribute in documentation pages' metadata).
-
In the
www-gitlab-comrepository, update:-
data/stages.yml, with your new assignment. If you're onboarding as a new Technical Writer, you can wait until you've completed a full release cycle as a trainee before doing this step and the next steps.
- In the
gitlabrepository, update as needed (in the following order, but can be done in the same MR):- The metadata in all related markdown files (if the group name changed).
-
Group assignments in
lib/tasks/gitlab/tw/codeowners.rake. -
.gitlab/CODEOWNERSby running thetw:codeownersRake task to ensure no pages are missed.
-
-
If the group was previously assigned to the
#docschannel, add it to the TW milestone plan template. -
If you manually edited the following to include your group names, update them:
-
Slack profile: Update the
Titlesection that displays under your profile picture and name. -
Team member profile: Update the
rolevalue. Don't editspecialtybecause it syncs directly from Workday.
-
Slack profile: Update the
Tasks for technical writing manager
- Update google sheets used for team rebalancing planning.
- If this transition impacts a group with a stage lead, update the list of TWs for the stage in the stage lead issue script, the milestone planning issue template, and in the current milestone planning issue.
- Check Workday for the Job Title Specialty (Multi-Select). If the specialty does not exist, create an issue in the People Group general project, and use the Workday: Job Title Specialty Request template.
-
Update Workday with the new group assignments. Log a HelpLab Workday Data Changes request to update the Job Title Specialty in Workday. Workday updates the group assignments in
data/team_members/person.
Edited by Isaac Durham