[wp-trac] [WordPress Trac] #65074: Rendering error of the wp_register_ability_category() doc page

[WordPress Trac]

#65074: Rendering error of the wp_register_ability_category() doc page
--------------------------------+------------------------------
 Reporter:  satollo             |       Owner:  (none)
     Type:  defect (bug)        |      Status:  new
 Priority:  normal              |   Milestone:  Awaiting Review
Component:  WordPress.org Site  |     Version:  6.9.4
 Severity:  normal              |  Resolution:
 Keywords:  has-patch           |     Focuses:
--------------------------------+------------------------------

Comment (by hbhalodia):

 Hi @iamadisingh @satollo,

 This issue is not limited to just these two functions. We have many hooks
 (both actions and filters) and functions that follow a similar format for
 defining parameters and return types. For example:
 https://developer.wordpress.org/reference/hooks/post_states_html/

 We should address this at a global level rather than fixing it by updating
 or removing the `@param` comments in individual cases, as seen in this PR:
 https://github.com/WordPress/wordpress-develop/pull/11574/changes

 I also suggest updating the issue title and description to reflect a
 global issue that applies to all such functions. Since we are adopting
 PHPStan, it will require precise array notations for parameter and return
 types. Therefore, simply removing these annotations will not be a viable
 solution.

 Thanks,

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