[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