Skip to content
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

Docs: Add post meta limitations to Block Bindings API docs #68583

Draft
wants to merge 1 commit into
base: trunk
Choose a base branch
from

Conversation

himanshupathak95
Copy link
Contributor

@himanshupathak95 himanshupathak95 commented Jan 10, 2025

Closes: #68574

What?

Add documentation about post-meta limitations in the Block Bindings API documentation, specifically covering protected meta and REST API requirements.

Why?

The current Block Bindings documentation doesn't mention important limitations regarding post-meta usage. Developers need to know upfront that:

  • Protected post meta (prefixed with underscore) cannot be used
  • Post meta must be available via REST API

How?

Add a callout alert section in docs/reference-guides/block-api/block-bindings.md before the "Compatible blocks and their attributes" section. The callout follows the existing documentation style and alerts about both limitations clearly.

Testing Instructions

  • Navigate to /docs/reference-guides/block-api/block-bindings.md
  • Find the new callout alert added before "Compatible blocks and their attributes" section
  • Verify the content clearly explains both limitations

Screenshots or screencast

Before After

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Bindings documentation does not mention limitation of protected post meta
2 participants