From 0bcae519294cc9ffc3b7955e02258ace72eb6a7e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mat=C3=ADas=20Ventura?= Date: Tue, 2 May 2017 19:18:58 +0200 Subject: [PATCH] Add inline documentation to blocks index. --- blocks/index.js | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/blocks/index.js b/blocks/index.js index c72da46d5c828..fd71c3133a898 100644 --- a/blocks/index.js +++ b/blocks/index.js @@ -3,5 +3,14 @@ */ import './library'; +// A "block" is the abstract term used to describe units of markup that, +// when composed together, form the content or layout of a page. +// The API for blocks is exposed via `wp.blocks`. +// +// Supported blocks are registered by calling `registerBlock`. Once registered, +// the block is made available as an option to the editor interface. +// +// Blocks are inferred from the HTML source of a post through a parsing mechanism +// and then stored as objects in state, from which it is then rendered for editing. export * from './api'; export * from './components';