Block Editor End User Documentation needs help

Over the last four months, I have been working on the infrastructure, processes, a page inventory, updates on existing pages and new pages for the BlockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. editor.

There are gaps in the existing documentation 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 UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing. changes on for every version, we need more contributors.

It’s time we expand the number of contributors!

The upcoming virtual Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of There are many teams that people can participate in, each with a different focus. at WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe is a great occasion to bring new contributors on board. Here are some instructions and thoughts for new contributors on how to get started. Your feedback is wanted and you can share your ideas, as well as your questions in the comments below.

Hello, New contributors!

Thank you for volunteering to work on Block Editor End Documentation! My name is Birgit Pauli-Haack. My SlackSlack Slack is a Collaborative Group Chat Platform The WordPress community has its own Slack Channel at username is @bph. PingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” me on Slack if you have questions or ideas, either publically in the #docs channel or via private message and I will respond quickly, yet asynchronously.

Office Hours for WCEU Contributor Day is on Thursday, May 28, 2020, 15:00 UTC – on Slack in the #docs channel.

Required skill sets:

What tools do we use?

We use Google Drive and Slack to coordinate our work. 

Screenshot Capabilities

To illustrate our documentation screenshots are essentials. You would need to know how to create screenshots with your own operating system and how to convert them into image to be uploaded to your text.

Basic knowledge of Google Docs

  • How to copy a document
  • How to add images
  • How to format text
  • Sharing options for your document

Bare-bones WordPress Website

To shoot basic screenshots, you would need a self-hosted install of WordPress with the latest WordPress release (as of now 5.4.1). Many plugins add additional screen properties to the editor or your WP Admin that will confuse user, when they compare your screenshot with their own. If you can’t install WordPress on your computer, most hosting companies allow you to create sites with a temporary URLURL A specific web address of a website or web page on the Internet, such as a website’s URL without increasing your hosting costs. Contact me, if you need assistance with this.

What about Creating Videos?

Videos are not our primary tool to help end users with the block editor. We try to explain everything in writing and with screenshots. However, sometimes it helps to just show how a certain screen option behaves in sequence to augment the written explanation. You see a few very short videos embedded into pages. It’s an enhancement and might not come into play in the first version of your documentation article. Also, the tools are not easily available and require additional skill sets.

First tasks for new contributors

The most immediate tasks is creating new pages for each Embed block of the Block editor. Here is the list in a spreadsheet.

Please select the one block you want to work on next, and enter your information into the respective columns.

  • Enter your name,
  • Your email address and
  • Your Slack user name
  • Deadline (optional)

It’s not necessary to add a date into the deadline column, although it helps to know approximately when you might find time to finish it. Don’t worry, we won’t hold your feet to the fire. Those dates are approximations, and for me, there are also a way to know when to check in with you and if everything is on track or if there are any blockers.

“If it weren’t for the last minute, nothing would get done.”

Rita Mae Brown

Are we done with the preliminaries? Let’s get documenting!

We prepared a Google Doc Sample for Embed blocks with instructions.

  • Please copy the document to your Google Drive.
  • Share the link to Your Google Doc in the spreadsheet.
  • Start working on your first page!

As you can see it’s a bit of a set-up, but once you are through the preliminaries (Slack account, Google Account, clean install, Google Doc) you are up and running.

Three Examples: Twitter, Facebook, YouTube

We have three embed blocks already on site, their example might help you decide how deep you can go into your explanations.

When you are done with your first draft, let us know on Slack, and we’ll review it together.

Again, thank you for volunteering to work on the Block Editor End user documentation. We are thrilled to have you onboard!

If you are testing on a self-hosted site, and you can activate the GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the Plugin Directory or can be cost-based plugin from a third-party, please add also the Gutenberg 8.1 screenshots for the embed block on the bottom of the Google Doc. With the new WordPress version coming in August we will need to update your pages again to include the new UI. Add the screenshots will give us a head start on those changes.

Disclaimer: This is the first version of these onboarding instructions and you are the first contributors working this way.


  • Updated 2020-05-20
    • Added a paragraph regarding Gutenberg plugin screenshot to prepare for the WordPress 5.5 changes to come in August 2020.
  • Created 2020-05-18