Skip to content

Writer onboarding

Birgit Pauli-Haack edited this page Jan 13, 2025 · 5 revisions

Add writers to GitHub

All writers are added to the Developer Blog Contributors team.

If they are not part of either teams (Developer Blog or Developer Blog Contributors) add them to the Contributor team. Video: How to Add the writer to the Developer Blog Contributors team – (no sound).

Screen.Recording.2024-07-29.at.13.04.44.mov

You might see a note next to the GitHub user "Not a member of this organization". not-a-member-of-org

It can happen that you won’t be able to finish the step because the contributor is not part of the WordPress organization. For that, you would need to connect with Jonathan Derosiers or any other org owner via DM and ask them to add the writer with their GitHub account to the WordPress organization.

After the writer is part of the Developer Blog Contributors, you can assign issues, and they can label issues, access the project board, to move issues along and check items on a checklist someone else posts.

Once the issue is assigned, you can add a comment to the issue and point the new writer to the following resources:

Tips and guidelines for writers How to contribute Notes on creating and formatting a Google Doc #242 First comment

Often new writers need to be reminded about the No “we” guideline, and the external link policy.

Once the draft on Google has been reviewed, it’s time add the writer to the blog and if necessary, to the /wptrainingteam organization to house the examples code.

Add Writer to the Developer Blog Site

Add the writer to the blog: You would need to have administrator access to the Blog and know the wp.org username of the writer:

Display First and Last Name in author link

  • Log into the WP Dev blog and
  • go to your profile (https://developer.wordpress.org/news/wp-admin/profile.php)
  • Go to the Name section and make sure the First Name and Last Name are filled out with your first and last name
  • Next to Display name publicly as, select the option to display your first and last name
  • Scroll all the way down and click the blue Update Profile button

User profile on Developer Blog

Add a writer to the WP training organization.

You would need to have admin rights on the GitHub organization. Currently, that’s @justinleetadlock, @bph and @marybaum for the Developer Blog and @jbossenger and @kaitohm on the Training team. Once the writer is a member of the organization, they can create a new repo and upload their code. They can also just transfer an existing repo from their account to the organization.

Note: Stress that they create the repo as public. If they set it to private, they need another maintainer to set it to public.