[wp-trac] [WordPress Trac] #53399: Docblock improvements for WP 5.9

WordPress Trac noreply at wordpress.org
Tue Sep 7 19:35:10 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 johnbillion):

 Replying to [comment:27 SergeyBiryukov]:
 > Do you have a preference here? Perhaps the notes above should be
 converted to `@internal` instead?

 @SergeyBiryukov To be honest I don't think these comments provide value to
 a developer. Whether or not a function internally wraps another one is of
 no consequence if it doesn't affect its external API. I'd be in favour of
 removing them.

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


More information about the wp-trac mailing list