Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Marketing Handbooks "Get Involved" pages to improve contribution process for Marketing contributors #169

Open
6 tasks
sereedmedia opened this issue Jan 27, 2023 · 8 comments
Assignees
Labels
documentation Improvements or additions to documentation handbook

Comments

@sereedmedia
Copy link
Contributor

The various Make team handbooks across the WordPress project take a varied approach to onboarding new contributors. Additionally, onboarding is being discussed at a higher level in this conversation on Five for the Future contribution journeys.

Rather than start with the bigger picture of project onboarding, how can we improve the existing contributor onboarding process for the Marketing team?

The current Marketing team onboarding docs start here, with subsequent subpages: https://make.wordpress.org/marketing/handbook/getting-involved/

The current outline is:
Get Involved

  1. New Contributor Training
  2. Coffee Breaks
  3. Communication
  4. What are our tasks?
  5. Getting Started on a Task
  6. Creating Meeting Notes
  7. Marketing Team at Contributor events
  8. Team Reps

To review and refine this process we need to:

  • 1. Map the existing new Marketing contributor journey and resources
  • 2. Determine what existing information/resources need to be updated
  • 3. Determine what additional information/resources could improve existing resources/process
  • 4. Collect/create additional resources as needed
  • 5. Edit and revise
  • 6. Update the Marketing-team specific onboarding process and resources

After we conclude this process for Marketing (or in conjunction with any existing efforts happening), we can look at collaborating with other teams to create general/generic onboarding documents for new contributors (specifically in terms of using the WordPress tools, understand process, meetings, chats, etc.). Those docs could possibly be part of the Contributor Handbook in the future.

@sereedmedia
Copy link
Contributor Author

sereedmedia commented Jan 27, 2023

New contributor Francisco Opazo recently commented on this issue in the Marketing channel here: https://wordpress.slack.com/archives/C0GKJ7TFA/p1674723488166949

He asked the following questions:

  • How meetings are handled
  • How to contribute during the meetings
  • How to use Github to see what projects needs help
  • Who are the right persons to talk about where to start helping
  • How to brief or scope ideas to be executed or discussed
  • What is the structure of the team, go to person for x topics, etc.
  • Where the information or announcements are hosted: I can see sometimes blog posts, cards, or here, it is hard to keep track.

Some of the answers to these questions are being addressed/developed in other discussions/issues, but they can be relevant in terms of getting that information in a palatable format for new contribs.

@sereedmedia sereedmedia self-assigned this Jan 27, 2023
@sereedmedia sereedmedia changed the title Update Marketing Handbooks "Get Involved" pages to contribution process for Marketing contributors Update Marketing Handbooks "Get Involved" pages to improve contribution process for Marketing contributors Jan 31, 2023
@sereedmedia
Copy link
Contributor Author

For reference, a previous GH issue seeking feedback to revise the Marketing handbook was here: #47 In it @eidolonnight asked some good questions to consider when reviewing Handbook content (or documentation generally):

  • What information is missing?
  • What information is unclear?
  • Is any content outdated?
  • Is any content inaccurate?

@sereedmedia
Copy link
Contributor Author

sereedmedia commented Jan 31, 2023

I am preserving some comments from @nalininsbs in a now-closed ticket here: #98 (comment)

The original question was why the following information in the meeting (which it no longer is). I feel, however that this would be a useful list/resource (updated as needed), to include in the marketing handbook.

Can we please add a sentence about the context of the people mentioned to help people coming new to the team and whether we are asking people to contact them or do anything. I have also standardized the references to teams in the list and amended those which are groups. Could we review this and then use this list in future? Thank you @eidolonnight and @murillol . Do we need to include them in the notes each week or are they now static and could be in the handbook?

WordPress Features/Release (#WordPress) - @Lauren and @Dan Soschin working with those working on the Release
Ad hoc updates from WordPress.org/news - @Brett McSherry
Learn WordPress (#LearnWP) - @Dan Soschin along with the Training team
WP Diversity (#WPDiversity) - @Santana.Inniss along with @jillbinder and the WP Diversity working group in the Community Team
Openverse (#WPOpenverse) - @Reyes Martínez along with the Openverse team
Photo Directory (#WPPhotos) - @Reyes Martínez along with the Photo team
Grow Your Story (#GrowYourStoryWP) - @jpantani along with the Design team
WP Briefing podcast (#WPBriefing) - @Santana.Inniss (((Is this with anyone/ any team?)))
WordCamp (#WordCamp) - @Brett McSherry (((Is this with the Community team?)))

@nalininsbs
Copy link
Contributor

These will be useful references for what the Training Team is doing in the area of onboarding. They were shared at today's Training Team meeting.
https://make.wordpress.org/training/2022/11/26/project-thread-training-team-onboarding-paths/
https://make.wordpress.org/training/2022/10/21/proposal-create-a-new-onboarding-experience-to-the-training-team/

@abhansnuk abhansnuk added documentation Improvements or additions to documentation handbook labels Feb 1, 2023
@sereedmedia sereedmedia reopened this Feb 13, 2023
@sereedmedia
Copy link
Contributor Author

this was incorrectly marked as completed.

@santanainniss
Copy link

@jennimckinnon are you here?! :)

@jennimckinnon
Copy link

@santanainniss I sure am! I'm thrilled to be able to help with this one.

@sereedmedia
Copy link
Contributor Author

Updated "Getting Started with our Tasks" to include current tools and content.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation handbook
Projects
None yet
Development

No branches or pull requests

5 participants