[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
Wed Aug 28 15:30:39 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 flixos90):
Replying to [comment:7 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] ?
Could you clarify what you think soft deprecation could look like in this
context? The documentation already states that these values are only
supported for backward compatibility.
Regarding hard deprecation, I don't think we should do that at this point.
From a code perspective it would make sense, but historically we haven't
hard-deprecated things when they're still very commonly used in the
ecosystem and are easy to maintain (both of which applies here).
--
Ticket URL: <https://core.trac.wordpress.org/ticket/61929#comment:9>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list