Google Season of Docs 2021 – Project ideas list

Our application was not accepted for this edition of the Season of Docs. I received the email from Google on Friday, April 16th notifying me of this.

However, the projects we submitted will be highly beneficial to the documentation team, and to WordPress in general. So I’m very interested in leading/working on some of them, and also in supporting contributors who would like to do the same.

In the next few days, I’ll get in touch with the people who were interested in participating in this Season of Docs, and, if they are still interested, see how we can move forward.

Below is a list of projects presented by WordPress for Google Season of Docs 2021. Prospective technical writers can also suggest new project ideas in the comments section.

People involved:

Project list

Project one: @justinahinon

Project name: Create a system to track updates and suggestions to the WordPress documentation

Project description

The problem: The WordPress documentation is huge and divided into multiple sections. There is user documentation and developer documentation of different projects (themes, plugins, block editor, APIs, etc.).

All this documentation is subject to frequent changes as the projects to which they belong evolve. So we end up with requests for changes, requests for updates that are frequently reported on various channels: Slack, Meta Trac, GitHub, etc.

The fact that we don’t have a unified system for change requests and documentation updates makes collaboration difficult; and can be an obstacle for new contributors who want to start with documentation contribution.

So, WordPress really needs to have a unified tracking system so that we can track these requests and the work to fulfill such requests. And we need to create a process to utilize this system properly.

Measuring the project’s success

The main indicator of success is the effective implementation of a system and process to report documentation that is obsolete, needs to be updated or corrected.

The second indicator of success is the use by contributors of the system and process implemented.

Required skills

The technical writer who will work on this project should have an idea of WordPress documentation, how they work, and how the documentation team maintains them.

The technical writer will have a mentor with experience on the documentation team, who can provide assistance and guidance as needed.

Project two: @chaion07

Project name: Documentation for a better on-boarding experience: Supporting new contributors to WordPress

Project description

The problem: Reported by W3Techs WordPress currently powers over 40% of the web. The WordPress Org comprises of contributors and the number is growing by the day. With 18 Make WordPress Teams it can be a daunting experience for new contributors in finding their place. Many teams have their on-boarding documentations as part of the Handbook. Some are automated, for example the core team while others lack enough clarity for new contributors to understand.

Thus, WordPress should include both technical and other know-how documentation for contributors. Season of Docs is the perfect excuse to improve each of the 18 teams’ handbooks emphasizing on the contributor on-boarding experience.

This project aims to improve the documentation of the on-boarding experience for contributors. With rich, interactive content including multilingual videos, the goal is to support the existing documentation from individual team’s handbooks and to standardize them in a way that can be truly beneficial for the contributors.

Measuring the project’s success

Adding relevant section to the handbooks and those pages would be the main success criteria for the project. Being able to include localized content can also help improve the overall user experience and reach a wider audience.

An additional success criteria for the project can also be on the use of the content and in the implementation of the content when put to the test.

Required skills

The technical writer should have an understanding on the following:

  • How Make WordPress Teams function
  • Weekly Meetings and Triage Sessions
  • Workflow of the Make WordPress Teams
  • How to propose changes for the Handbook
  • How WordPress is being improved (release process)
  • Where to ask for help and how to avail them
  • Identifying the contact person for each Make WordPress Teams

The technical writer can have a mentor with experience on the documentation team, who can provide assistance and guidance if needed.

Related Material

Project three: @tacitonic

Project name: Write Gutenberg block editor end-user documentation


There are gaps in the existing documentation for the Gutenberg block editor with missing pages and existing pages that need to be updated – as 80% of them haven’t seen an update since WordPress 5.0 came out. With constant UI changes on for every version, Gutenberg block editor documentation is evolving rapidly with new version releases.

Required skills

A content creator’s (blogger, writer) understanding for the block editor; no development skills are required.

Related material

Project four: @tacitonic

Project name: Improve existing user and developer documentation and handbooks


We have a lot of developer documentation. WP Core’s documentation is mostly automated. However handbooks that describe how one would create a theme, make a plugin, use the REST API, or automate things via the CLI do not receive updated documentation. In turn, this requires that all handbook maintainers know all the changes in each core release to be able to write something useful.

In some cases, the handbooks are updated but don’t provide enough examples for new developers to get started. We would like to close these gaps.

Another improvement would be to adopt the newly published WordPress Documentation Style Guide for existing documentation.

Related material

Project five: @mkaz

Project Name: Extending block editor developer documentation


Documentation on developing on top of block editor is, depending on the topic, either scarce, outdated, or non-existent. Considering that the block editor is a significant language leap for WordPress developers, the project itself would benefit from having detailed documentation in a form of guides or tutorials, on how to utilize and extend core functionality and what the best practices are.

Related material

Additional information

  • Previous participation in Season of Docs, Google Summer of Code or others:
    WordPress participated in Google Season of Docs 2020. WordPress was also a mentoring organization for Google Summer of Code 2014.


Call for projects ideas for the Google Season of Docs 2021

UPDATE: Refer for the final project list for Season of Docs 2021.

Got any ideas for WordPress documentation projects for the Google Season of Docs? Share them with us! Project proposals should be in such a way that they can benefit from the work of the technical writers.

Please share your project ideas by Wednesday, March 24, 2021, UTC 11:59.


Call for mentors for the Google Season of Docs 2021

If you’ve been reading the Make/Docs blog this week, then you already know that WordPress will be applying for the Google Season of Docs 2021.

In order to help the technical writers with the projects they will be choosing, it would be ideal if they were accompanied by one or more mentors who have some experience with WordPress documentation. Although it is not mandatory for this edition of the program, we think it could be very beneficial.

If you would like to learn more about the role of a mentor, please read this guide for program mentors.

If you are interested in being a mentor, please mention it in a comment to this post with Wednesday, March 24, 2021, UTC 11:59.


WordPress is applying to Google Season of Docs 2021

This year, WordPress will again apply for the Season of Docs.

What is the Season of Docs?

The Season of Docs is a Google program. It offers open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. projects an opportunity to improve their documentation. The program also offers technical writers the opportunity to contribute to these open source projects and improve their technical writing skills.

Previous WordPress participations in the Season of Docs

WordPress participated in the 2020 edition of Season of Docs. Two projects were selected for this edition:

The contributors to these projects have made outstanding efforts to achieve them, and the completion of these projects is already having a positive impact on overall WordPress documentation (read WordPress Documentation Style Guide – Google Season of Docs 2020 Project Report).

Who is involved?

At this stage, I am the only person involved as the WordPress organization administrator.

What do we need right now?

To participate in Season of Docs 2021, we need:

  • Projects: (a post will be published soon on the blog to collect project ideas)
  • Mentors: mentors are not required for the 2021 Season of Docs. However, it is very helpful for technical writers to have someone with experience with WordPress and its documentation to provide assistance when needed
  • A backup organization administrator: the organization administrator manages the organization’s participation in the Season of Docs. The administrator role consists in:
    • Being the liaison between Google and the program participants in the organization.
    • Providing regular updates to Google about the progress of the organization participation.
    • Taking care of all the paperwork related to the organization’s participation in the program.

It is therefore ideal to have a backup administrator who can help the first one, and if necessary, can take the lead in case of unavailability.

I live in Benin, in the UTC+1 time zone. It would be ideal to have a backup administrator who lives in a timezone far from mine (more or less).
If you are interested in being a backup administrator, please let me know in the comments of this post.


Here are some links to learn more about the Season of Docs: