[wp-trac] [WordPress Trac] #30989: Additional audit for recent documentation changes

[WordPress Trac]

#30989: Additional audit for recent documentation changes
----------------------------+------------------------------
 Reporter:  SergeyBiryukov  |       Owner:
     Type:  defect (bug)    |      Status:  new
 Priority:  normal          |   Milestone:  Awaiting Review
Component:  General         |     Version:  4.1
 Severity:  normal          |  Resolution:
 Keywords:  dev-feedback    |     Focuses:  docs
----------------------------+------------------------------
Changes (by SergeyBiryukov):

 * keywords:   => dev-feedback


Comment:

 If a function returns a string on success and false on failure, does it
 make a difference if `string` comes first in the `@return` value? I
 thought `string|bool` is preferred, but was confused by some of the
 changes in [30674].

 Looks like some of the recent changes attempted to clarify `bool` and
 changed it to `false`.

 Should we standardize on `string|false` in that case?

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