Repository navigation
Packages: Add cross-version compatibility skill #81890
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
Merged
Merged
Changes from 9 commits
Commits
Show all changes
12 commits
Select commit
Hold shift + click to select a range
f6de46b
Design System: Add UI compatibility skill
ciampo 6854431
Packages: Generalize compatibility skill
ciampo 6c2afc3
Packages: Codify compatibility overlap windows
ciampo a8aa3dd
Design System: Clarify compatibility skill routing
ciampo aa7b363
Packages: Simplify compatibility skill trigger
ciampo d878b25
Packages: Refine cross-version compatibility guidance
ciampo c54b616
Packages: Tighten compatibility guidance prose
ciampo bfcaa3f
Packages: Restore precise compatibility wording
ciampo f826224
Packages: Document React context identity
ciampo deb17c5
Packages: Simplify compatibility guidance
ciampo 8850415
Packages: Make compatibility guide easier to read
ciampo c127944
Packages: Add cross-version compatibility example
ciampo File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| --- | ||
| name: package-runtime-compatibility | ||
| description: Use when changing or reviewing a published package across independently updated package and WordPress versions, including API, dependency, entrypoint, registration, allowlist, opt-in, and compatibility changes. | ||
| --- | ||
|
|
||
| # Assess package and runtime compatibility | ||
|
|
||
| 1. Read the package guide's [cross-version compatibility procedure](../../../packages/README.md#maintaining-cross-version-compatibility). | ||
| 2. Name the contract that changes and the package and runtime versions that can run together in production. Include each supported entrypoint. | ||
| 3. Confirm what the bundle contains and what WordPress supplies. Check package metadata, build configuration, dependency extraction, generated artifacts, module-load gates, React context objects, and other state or identities that package copies must share. | ||
| 4. Run the guide's direct-consumer check and four version pairings where they apply. | ||
| 5. Before removing compatibility code, find the older package versions that still use it and check maintained downstream bundles. | ||
| 6. Mark each required pairing as `pass`, `fail`, or `unverified`. Do not remove the compatibility code while a required pairing is unverified. | ||
| 7. When adding compatibility coverage, follow the [testing skill](../testing/SKILL.md) and establish the unsupported pairing before implementing its bridge or fallback. | ||
| 8. Report the evidence, required compatibility or support change, release order, migration target, and any unverified runtime. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.