Block documentation structure

In this website the documentation for a block is developed in a number of stages. This post may help you to determine the status of the documentation for any particular block.

The stages are:

  • Identify a plugin with blocks
  • Install the plugin
  • Create the block list for the plugin
  • Generate the blocks for the plugin’s namespace
  • Complete the documentation for each block

Generated block structure

An automatically generated block contains the following blocks.

Generated block example

oik-block/blockicon
Block icon
Displays a Block icon
widgets
icon,oik,block

Under construction.

Screenshot

Please set featured image

Example

Type / to select block


Notes

  • TBC

Completed entry

  • A completed entry will have the correct Block info with the appropriate icon and description.
  • This is followed by the More block. The Excerpt field is left blank, so the previous block is used whenever the Excerpt is displayed.
  • The light grey block contains some basic notes about the block.
  • There will be a screenshot and a working example.
  • The Notes section may contain a variety of notes, some of which are observations.
  • Additionally there will be values for all the fields in the Information section.

Information fields

Field labelExampleNotes
Block type name:core/paragraphThis should be the same value as in the title
Plugin ref:WordPressA link to the plugin that delivers this block.
Block categories:commonA block category link for all blocks with this category.
Only one expected.
Block keywords:textBlock keyword links for blocks with these keywords.
No longer limited to 3 keywords.
Block classification:StaticA manually created taxonomy used to define how the block operates. e.g. Static, Dynamic, Server Side Rendered.
Block letters:PLinks to the Block Letter taxonomy display for blocks.
Up to 5 allowed.