[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