[wp-trac] [WordPress Trac] #61929: Update documentation for remaining autoload functions to only include `true|false` as parameter values

WordPress Trac noreply at wordpress.org
Tue Aug 27 17:08:22 UTC 2024


#61929: Update documentation for remaining autoload functions to only include
`true|false` as parameter values
--------------------------------+--------------------------------
 Reporter:  flixos90            |       Owner:  flixos90
     Type:  defect (bug)        |      Status:  assigned
 Priority:  normal              |   Milestone:  6.7
Component:  Options, Meta APIs  |     Version:
 Severity:  normal              |  Resolution:
 Keywords:  has-patch           |     Focuses:  docs, performance
--------------------------------+--------------------------------

Comment (by joemcgill):

 > If anything, it will lead to certain linting tools (e.g. PHPStan)
 complaining, which I think is something that we would want.

 I agree that this could help people adopt the new boolean values. Given
 that you're only targeting the two new functions that were added in 6.4, I
 think this makes a lot of sense, before they are widely adopted. We do
 include more context and a `@since` note on the changes we made to the
 more widely used functions, like `add_option()`, which you can see
 [https://github.com/WordPress/wordpress-
 develop/blob/575b321c84e976080b03cbb8cd61e339b3a4c3f5/src/wp-
 includes/option.php#L1036-L1044 here]. I think something similar would be
 valuable, otherwise I'm +1 this change.

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


More information about the wp-trac mailing list