[wp-trac] [WordPress Trac] #63746: Suggestion for Standardizing PHPDoc Comments for do_action Parameters in WordPress Core

[WordPress Trac]

#63746: Suggestion for Standardizing PHPDoc Comments for do_action Parameters in
WordPress Core
-------------------------+-------------------------------------------------
 Reporter:  viralsampat  |      Owner:  (none)
     Type:  enhancement  |     Status:  new
 Priority:  normal       |  Milestone:  Awaiting Review
Component:  General      |    Version:
 Severity:  normal       |   Keywords:  has-patch dev-feedback needs-
  Focuses:  docs         |  testing 2nd-opinion
-------------------------+-------------------------------------------------
 Hello Team,

 While reviewing the WordPress core files, I noticed that some do_action
 calls include PHPDoc blocks documenting their parameters. I believe
 standardizing PHPDoc comments for all do_action parameters across the core
 codebase could significantly improve code readability, enhance static
 analysis, and provide clearer documentation for developers.

 This consistency would be particularly helpful for contributors and
 developers working with hooks, as it improves understanding of the data
 passed through actions.

 It might be worth considering a standardized approach to this across the
 Core codebase.

 Thank you,

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/63746>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform