[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 22:20:46 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 jrf):

 Might it be an idea to official mark those old values as deprecated ?
 Either soft deprecated (documentation only) or hard deprecated and flagged
 via a call to the
 [https://developer.wordpress.org/reference/functions/_deprecated_argument/
 `_deprecated_argument()` function] ?

 And yes, there is precedent for this in WP, not just for a deprecated
 argument, but also for passing a specific argument value to an argument.
 See: https://github.com/WordPress/WordPress-Coding-
 Standards/blob/dfd6c3a8ee61eed6af15bda09f4a33d79eb2b86b/WordPress/Sniffs/WP/DeprecatedParameterValuesSniff.php#L67-L209
 (the list in the sniff is based on calls to the `_deprecated_argument()`
 function within WP for deprecated argument ''values'')

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


More information about the wp-trac mailing list