[wp-trac] [WordPress Trac] #65390: Docs: Fix malformed and missing @since tags in WP_Theme_JSON for responsive block nodes

[WordPress Trac]

#65390: Docs: Fix malformed and missing @since tags in WP_Theme_JSON for responsive
block nodes
--------------------------+---------------------
 Reporter:  khokansardar  |       Owner:  (none)
     Type:  defect (bug)  |      Status:  new
 Priority:  normal        |   Milestone:  7.1
Component:  Editor        |     Version:  trunk
 Severity:  trivial       |  Resolution:
 Keywords:  has-patch     |     Focuses:  docs
--------------------------+---------------------
Changes (by sabernhardt):

 * component:  Bundled Theme => Editor
 * milestone:  Awaiting Review => 7.1


Old description:

> When responsive global styles for blocks were added in [5bc40a6], two
> @since documentation issues were introduced in src/wp-includes/class-wp-
> theme-json.php:
> 1. WP_Theme_JSON::get_block_name_from_metadata_path() has @since 7.1 —
> missing the patch version. WordPress coding standards require three-part
> version strings. Should be @since 7.1.0.
> 2. WP_Theme_JSON::get_block_nodes() was extended to generate responsive
> block nodes for breakpoint-based styles, but no @since 7.1.0 changelog
> entry was added to its docblock. The existing @since chain ends at 6.7.0.

New description:

 When responsive global styles for blocks were added in [62444], two
 `@since` documentation issues were introduced in `src/wp-includes/class-
 wp-theme-json.php`:
 1. `WP_Theme_JSON::get_block_name_from_metadata_path()` has `@since 7.1` —
 missing the patch version. WordPress coding standards require three-part
 version strings. Should be `@since 7.1.0`.
 2. `WP_Theme_JSON::get_block_nodes()` was extended to generate responsive
 block nodes for breakpoint-based styles, but no `@since 7.1.0` changelog
 entry was added to its docblock. The existing `@since` chain ends at
 6.7.0.

--

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/65390#comment:2>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform