[wp-trac] [WordPress Trac] #58963: Expand `$autoload` parameter documentation of `add_option()` and `update_option()`

[WordPress Trac]

#58963: Expand `$autoload` parameter documentation of `add_option()` and
`update_option()`
--------------------------------+-------------------------
 Reporter:  flixos90            |      Owner:  (none)
     Type:  task (blessed)      |     Status:  new
 Priority:  normal              |  Milestone:  6.4
Component:  Options, Meta APIs  |    Version:
 Severity:  normal              |   Keywords:  needs-patch
  Focuses:  docs, performance   |
--------------------------------+-------------------------
 As outlined with more context in #42441 and #58962, "excessive
 autoloading" (i.e. autoloading too many options) can lead to performance
 problems, in some cases huge ones that even cause bugs.

 Part of the problem is that there is very little documentation on option
 autoloading, which makes it challenging for the WordPress ecosystem to
 understand and properly use it. This also is reflected in ''extremely''
 limiting, and possibly even misleading inline documentation of the
 `$autoload` parameter of `add_option()` and `update_option()`.

 This ticket aims to update said inline documentation to provide additional
 context on what the parameter does and how it should be used.

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