-
Notifications
You must be signed in to change notification settings - Fork 4.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Rename experimental-theme.json to theme.json and add a fallback for backwards-compatibility #29981
Conversation
cc @JustinyAhin for a review of the docs changes |
Thanks for the PR Ari, It's great to have this ready. I think we should hold a bit on this PR until we make the necessary changes suggested in #29891 |
Sure, though with the fallback in https://github.com/WordPress/gutenberg/pull/29981/files#diff-41112e4d1e1b9d7fe224c7c598fb56d7ed165d57335008129e1c4658252fb037 I don't think anything will break 😉 |
Size Change: 0 B Total Size: 1.31 MB ℹ️ View Unchanged
|
It's more about the "format" for me and also a "communication" aspect. If we decide that we need some small breaking change in the format. For an experimental file, it's clearly mentioned on our docs that changes are expected https://developer.wordpress.org/block-editor/contributors/code/coding-guidelines/#experimental-and-unstable-apis |
Makes sense 👍 |
Time to get this one refreshed and merge. The new format is in. Thanks for the patience :) |
f74a815
to
80ed51e
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, the fallback is a good addition :)
Description
With the FSE MVP closing in, we should rename
experimental-theme.json
totheme.json
.This PR makes the necessary changes to documentation files, and also in the JSON resolver.
For backwards-compatibility and to avoid existing FSE themes from breaking, this PR also adds a fallback so if
theme.json
can't be found it tries to useexperimental-theme.json
.How has this been tested?
Tested with an existing FSE theme and nothing seems to be breaking. Then renamed the
experimental-theme.json
file totheme.json
inside the theme root folder, and again nothing breaks.Checklist: