Skip to content

Docs: Clarify Tag Processor mutation output#75

Draft
sirreal wants to merge 1 commit into
trunkfrom
docs/html-api-tag-mutations
Draft

Docs: Clarify Tag Processor mutation output#75
sirreal wants to merge 1 commit into
trunkfrom
docs/html-api-tag-mutations

Conversation

@sirreal

@sirreal sirreal commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Summary

  • Clarifies Tag Processor construction and the template pattern for safely filling attributes and text.
  • Documents that set_modifiable_text() only updates the currently matched text-bearing token.
  • Clarifies attribute placement, add_class() no-op behavior, and get_updated_html() as the queued-update readback API.

Verification

  • php -l src/wp-includes/html-api/class-wp-html-tag-processor.php
  • git diff --check

Trac ticket: TBD

Use of AI Tools

AI assistance: Yes
Tool(s): Codex
Used for: Reviewing the generated documentation-improvement branch, splitting evidence-backed changes into focused PRs, drafting wording, and running local verification. Final changes were reviewed against source behavior and experiment notes.

@sirreal sirreal added this to the HTML API docs milestone Jun 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant