Skip to content

iAPI Docs: Introduce reactive vs non-reactive distinction early in the state/context guide#75357

Merged
juanmaguitar merged 3 commits intotrunkfrom
iapi-docs-introduce-config-early
Feb 24, 2026
Merged

iAPI Docs: Introduce reactive vs non-reactive distinction early in the state/context guide#75357
juanmaguitar merged 3 commits intotrunkfrom
iapi-docs-introduce-config-early

Conversation

@luisherranz
Copy link
Copy Markdown
Member

What?

Follow up to #71355

Introduce the distinction between reactive and non-reactive data at the beginning of the Interactivity API state/context guide.

Why?

As @DAreRodz pointed out in the review of #71355, the term "config" is not introduced until the very end of the document. Adding a reactive vs non-reactive distinction at the beginning helps readers understand the full picture before diving into details.

How?

  • Updated the introductory paragraph to mention config alongside global state, local context, and derived state.
  • Grouped the definitions into Reactive (state and context) and Non-reactive categories.
  • Added a brief definition of config in the introduction.

@luisherranz luisherranz requested a review from DAreRodz February 9, 2026 22:02
@luisherranz luisherranz self-assigned this Feb 9, 2026
@luisherranz luisherranz added the [Type] Developer Documentation Documentation for developers label Feb 9, 2026
@luisherranz luisherranz added the [Feature] Interactivity API API to add frontend interactivity to blocks. label Feb 9, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Feb 9, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Unlinked Accounts

The following contributors have not linked their GitHub and WordPress.org accounts: @Copilot.

Contributors, please read how to link your accounts to ensure your work is properly credited in WordPress releases.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Unlinked contributors: Copilot.

Co-authored-by: luisherranz <luisherranz@git.wordpress.org>
Co-authored-by: DAreRodz <darerodz@git.wordpress.org>
Co-authored-by: juanmaguitar <juanmaguitar@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@juanmaguitar
Copy link
Copy Markdown
Contributor

With this addition, maybe we should rename the doc page to: "Understanding global state, local context, derived state and config"

@luisherranz
Copy link
Copy Markdown
Member Author

Sure.

@copilot can you do it? (I have no idea if this is possible 😄)

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 12, 2026

@luisherranz I've opened a new pull request, #75473, to work on those changes. Once the pull request is ready, I'll request review from you.

@luisherranz
Copy link
Copy Markdown
Member Author

With this addition, maybe we should rename the doc page to: "Understanding global state, local context, derived state and config"

Done by copilot in d0e43a1

@luisherranz
Copy link
Copy Markdown
Member Author

@copilot merge trunk and resolve conflicts.

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 12, 2026

@luisherranz I've opened a new pull request, #75477, to work on those changes. Once the pull request is ready, I'll request review from you.

@luisherranz
Copy link
Copy Markdown
Member Author

@copilot can you merge this other PR into this one, make sure everything in that PR is covered here? It seems like a PR that should be unnecessary if we merge this one, but I want to make sure we're not forgetting anything.

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 13, 2026

@luisherranz I've opened a new pull request, #75512, to work on those changes. Once the pull request is ready, I'll request review from you.

@luisherranz
Copy link
Copy Markdown
Member Author

@copilot try to merge trunk and resolve the conflicts again.

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 13, 2026

@luisherranz I've opened a new pull request, #75514, to work on those changes. Once the pull request is ready, I'll request review from you.

@luisherranz
Copy link
Copy Markdown
Member Author

try to merge trunk and resolve the conflicts again.

It seems that Copilot is not able to do it, we'll have to do it manually.

@DAreRodz DAreRodz force-pushed the iapi-docs-introduce-config-early branch from 1b1b1ee to 726a311 Compare February 16, 2026 21:19
Copy link
Copy Markdown
Contributor

@DAreRodz DAreRodz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@juanmaguitar, I guess this would require a redirection in the Block Editor Handbook like the one you mentioned in #74974 (comment), right?

@github-actions
Copy link
Copy Markdown

Flaky tests detected in 726a311.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/22077821594
📝 Reported issues:

@luisherranz
Copy link
Copy Markdown
Member Author

@DAreRodz, thanks for fixing the conflicts.

@juanmaguitar, feel free to merge the PR once you think everything is ready!

luisherranz and others added 3 commits February 24, 2026 12:38
…75473)

* Initial plan

* Rename doc file to include config and fix typo

Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>
…5512)

* Initial plan

* Update manifest.json and toc.json to fix typo and include config

Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: luisherranz <3305402+luisherranz@users.noreply.github.com>
@DAreRodz DAreRodz force-pushed the iapi-docs-introduce-config-early branch from 726a311 to 2723578 Compare February 24, 2026 11:39
@juanmaguitar juanmaguitar enabled auto-merge (squash) February 24, 2026 11:53
@juanmaguitar juanmaguitar merged commit 884ec89 into trunk Feb 24, 2026
39 checks passed
@juanmaguitar juanmaguitar deleted the iapi-docs-introduce-config-early branch February 24, 2026 12:18
@github-actions github-actions bot added this to the Gutenberg 22.7 milestone Feb 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Feature] Interactivity API API to add frontend interactivity to blocks. [Type] Developer Documentation Documentation for developers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants