Target specific versions of WordPress in theme.json docs

[mrleemon]

Description

In the "Developing with theme.json" section of the Block Editor Handbook, the example shown uses the latest version of the schema (https://schemas.wp.org/trunk/theme.json), but there's no mention that a theme developer can also target specific versions of WordPress (https://schemas.wp.org/wp/5.9/theme.json).

https://developer.wordpress.org/block-editor/how-to-guides/themes/theme-json/#developing-with-theme-json

Step-by-step reproduction instructions

This is not a bug report

Screenshots, screen recording, code snippet

No response

Environment info

No response

Please confirm that you have searched existing issues in the repo.

Yes

Please confirm that you have tested with all plugins deactivated except Gutenberg.

Yes

[carolinan]

Note: the examples do not use the latest version. This page has not been updated.

[oandregal]

Hi, there're specific reference documents for different versions of theme.json https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/

The how-to guide should be updated to be focused on examples. This is up for grabs, anyone can contribute.

[ryanwelcher]

This would also apply to block.json as well.

[skorasaurus]

hi,

i believe this has been resolved in the later versions of the documents - https://github.com/WordPress/gutenberg/commits/trunk/docs/how-to-guides/themes/global-settings-and-styles.md ; specifically https://developer.wordpress.org/block-editor/how-to-guides/themes/global-settings-and-styles/#developing-with-theme-json

Please reopen if you don't feel that this has been addressed