[wp-trac] [WordPress Trac] #53399: Docblock improvements for WP 5.9
WordPress Trac
noreply at wordpress.org
Tue Aug 24 15:31:28 UTC 2021
#53399: Docblock improvements for WP 5.9
----------------------------+---------------------
Reporter: desrosj | Owner: (none)
Type: task (blessed) | Status: new
Priority: normal | Milestone: 5.9
Component: General | Version:
Severity: normal | Resolution:
Keywords: | Focuses: docs
----------------------------+---------------------
Comment (by SergeyBiryukov):
[attachment:53399.internal.diff] converts two `@internal` notes in `wp-
includes/ms-load.php` to `@since` tags.
This would be more consistent with other similar `@since` notes in core:
* `the_author_posts_link()`:
{{{
@since 4.4.0 Converted into a wrapper for get_the_author_posts_link()
}}}
* `date_i18n()`:
{{{
@since 5.3.0 Converted into a wrapper for wp_date().
}}}
* `language_attributes()`:
{{{
@since 4.3.0 Converted into a wrapper for get_language_attributes().
}}}
* `WP_REST_Server::error_to_response()`
{{{
@since 5.7.0 Converted to a wrapper of {@see
rest_convert_error_to_response()}.
}}}
This would be a follow-up to [34099] and [38515]. However, I noticed that
it reverts a part of [38201].
@johnbillion Do you have a preference here? Perhaps the notes above should
be converted to `@internal` instead?
--
Ticket URL: <https://core.trac.wordpress.org/ticket/53399#comment:27>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list