[wp-trac] [WordPress Trac] #39130: Docblock improvements for 4.8

[WordPress Trac]

#39130: Docblock improvements for 4.8
-------------------------------+-------------------
 Reporter:  johnbillion        |       Owner:
     Type:  task (blessed)     |      Status:  new
 Priority:  normal             |   Milestone:  4.8
Component:  General            |     Version:
 Severity:  normal             |  Resolution:
 Keywords:  ongoing has-patch  |     Focuses:  docs
-------------------------------+-------------------

Comment (by keesiemeijer):

 Just to clarify some of the patches.

 In [attachment:39130.5.patch] the DocBlock is not found by the parser
 because it's a comment. This has the consequence that it's imported as a
 duplicate filter (without the parameters).
 https://developer.wordpress.org/reference/hooks/image_size_names_choose-4/

 In [attachment:39130.7.patch] the `@since` parameter is only picked up by
 the parser if there's only one space before it. Now it's displayed in the
 description section instead of the change log section.
 https://developer.wordpress.org/reference/functions/wp_update_network_counts/

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