[wp-trac] [WordPress Trac] #63315: Docs: Improve the `prepare()` function inline docs

[WordPress Trac]

#63315: Docs: Improve the `prepare()` function inline docs
-----------------------------+------------------------------
 Reporter:  dilipbheda       |       Owner:  (none)
     Type:  defect (bug)     |      Status:  new
 Priority:  normal           |   Milestone:  Awaiting Review
Component:  Query            |     Version:
 Severity:  normal           |  Resolution:
 Keywords:  has-patch close  |     Focuses:  docs
-----------------------------+------------------------------
Changes (by SergeyBiryukov):

 * keywords:  has-patch => has-patch close


Comment:

 Hi there, thanks for the patch!

 The current description seems correct as is:
 * The `$args` and `...$args` parameters aim to differentiate between
 calling the method with an array of arguments to substitute into the
 query's placeholders and passing a
 [https://www.php.net/manual/en/functions.arguments.php#functions.variable-
 arg-list variable number of individual arguments]. The former part of the
 description should not be removed.
 * The `sprintf()-like` wording is correct, the hyphen is used to
 [https://www.reddit.com/r/EnglishLearning/comments/10ji8j0/when_should_one_use_the_hyphen_with_the_suffix/
 join the two words together as an adjective].

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