diff --git a/schemas/README.md b/schemas/README.md index a862bbd83c702c..1b2d8992cccb90 100644 --- a/schemas/README.md +++ b/schemas/README.md @@ -34,4 +34,30 @@ For a specific version of the schema, replace `trunk` with `wp/X.X`: Visual Studio Code and PhpStorm are two popular editors that work out of the box. However, some editors require a plugin installed, and not all editors recognize the `$schema` property. Check your editor's documentation for details. Additionally, [SchemaStore.org](https://www.schemastore.org/) and [JSON Schema](https://json-schema.org/implementations.html#editors) have lists of editors known to have support if your current editor is unsupported. +## Local Development + +You may wish to update one of the schemas to conform to a new change in the structure. In order to do this you'll want to be able to see how your changes impact how your IDE displays schema information. + +To allow this you will need to: + +- update your theme's `theme.json` to reference the _local_ version of the schema file: + +```json +{ + "$schema": "file://{{FULL_FILE_PATH}}/schemas/json/theme.json" +} +``` + +- update your block's `block.json` to include: + +```json +{ + "$schema": "file://{{FULL_FILE_PATH}}/schemas/json/block.json" +} +``` + +Be sure to replace `{{FULL_FILE_PATH}}` with the full local path to your Gutenberg repo. + +With this in place you should now be able to edit either `schemas/json/theme .json` or `schemas/json/block.json` in order to see changes reflected in `theme.json` or `block.json` in your IDE. + <br/><br/><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p>