fix(docs): Update documentation to specify valid tags for Block and Inline enum class references.

[terabytesoftw]

Pull Request

Q	A
Is bugfix?	✔️
New feature?	❌
Breaks BC?	❌

Summary by CodeRabbit

• Documentation
  • Updated documentation to clarify valid tag specifications for Block and Inline element references throughout the codebase. Changes improve accuracy and consistency of reference documentation without affecting functionality.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Documentation references across multiple element classes were updated to clarify tag specifications. Mentions of "a list of HTML elements" and "a list of inline-level HTML elements" in PHPDoc comments were changed to "valid ... tags" for consistency. A changelog entry documents this documentation improvement.

Changes

Cohort / File(s)	Summary
Documentation Updates src/element/BaseBlock.php, src/element/BaseInline.php, src/html/flow/Div.php, src/html/phrasing/Span.php	Updated PHPDoc comments to clarify tag references, replacing "a list of ... HTML elements" with "valid ... tags" in Block, Inline, Div, and Span class documentation.
Changelog CHANGELOG.md	Added entry for issue #111 documenting the documentation updates for Block and Inline enum tag specifications.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

• All changes are purely documentation (PHPDoc comments) with no functional code modifications
• Homogeneous pattern applied consistently across files (straightforward text clarifications)
• No behavioral, logic, or control flow changes

Poem

🐰 Hoppy hops, the docs are clear,
Tags and labels we hold dear,
From "lists" to "valid" we now say,
Clarity shines in every way!
Rabbit stamps this with a cheer,
Documentation's crystal here! ✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically summarizes the main change: updating documentation to specify valid tags for Block and Inline enum class references, which matches the actual changes across all files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix_mini_79

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b00d234 and 5d48730.

📒 Files selected for processing (5)

• CHANGELOG.md (1 hunks)
• src/element/BaseBlock.php (1 hunks)
• src/element/BaseInline.php (1 hunks)
• src/html/flow/Div.php (1 hunks)
• src/html/phrasing/Span.php (1 hunks)

🧰 Additional context used

🧠 Learnings (2)

📓 Common learnings

Learnt from: terabytesoftw
Repo: yii2-framework/ui-awesome PR: 55
File: src/tag/Lists.php:7-27
Timestamp: 2025-11-20T20:24:32.512Z
Learning: MDN's "Text content" section in the HTML Elements Reference includes list elements: dd, dl, dt, li, ol, ul. This is MDN's organizational structure for documentation, which differs from the HTML specification's formal content model categories.

📚 Learning: 2025-11-20T20:24:32.512Z

Learnt from: terabytesoftw
Repo: yii2-framework/ui-awesome PR: 55
File: src/tag/Lists.php:7-27
Timestamp: 2025-11-20T20:24:32.512Z
Learning: MDN's "Text content" section in the HTML Elements Reference includes list elements: dd, dl, dt, li, ol, ul. This is MDN's organizational structure for documentation, which differs from the HTML specification's formal content model categories.

Applied to files:

• src/element/BaseBlock.php
• src/element/BaseInline.php

🔇 Additional comments (5)

CHANGELOG.md (1)

115-115: LGTM! Changelog entry accurately documents the documentation fix.

The entry clearly describes the documentation update and follows the established format.

src/html/phrasing/Span.php (1)

27-27: LGTM! Documentation wording improved for clarity.

The change from "a list of inline-level HTML elements" to "valid inline-level tags" is more precise and aligns with the PR objective.

src/element/BaseInline.php (1)

46-46: LGTM! Documentation updated for consistency and precision.

The wording change to "valid inline-level tags" improves clarity and is consistent with related documentation updates across the codebase.

src/html/flow/Div.php (1)

27-27: LGTM! Documentation wording improved for block-level tags.

The change to "valid block-level tags" mirrors the inline-level documentation improvements and enhances precision.

src/element/BaseBlock.php (1)

46-49: LGTM! Comprehensive documentation update for all block-level tag types.

All four tag reference lines have been consistently updated to use "valid ... tags" instead of "a list of HTML ... elements," improving clarity and precision across Block, Lists, Root, and Table documentation.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[terabytesoftw]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.