[wp-trac] [WordPress Trac] #48349: Requests::request_multiple() should have the option documentation in phpDoc

[WordPress Trac]

#48349: Requests::request_multiple() should have the option documentation in phpDoc
--------------------------------------+-----------------------------
 Reporter:  marekdedic                |       Owner:  (none)
     Type:  defect (bug)              |      Status:  new
 Priority:  normal                    |   Milestone:  Future Release
Component:  HTTP API                  |     Version:  5.2
 Severity:  minor                     |  Resolution:
 Keywords:  good-first-bug has-patch  |     Focuses:  docs
--------------------------------------+-----------------------------
Changes (by adamsilverstein):

 * milestone:  5.4 => Future Release


Comment:

 I agree, it seems like the doc changes should be proposed and made
 upstream in the `Requests` project. Once we get changes merged there we
 can follow up to upgrade the core bundled version.  Otherwise, if we make
 these changes only locally in WordPress core, they would get overwritten
 if/when we update the `Requests` version we bundle.

 I searched through the [https://github.com/rmccue/requests/issues open
 issues] and didn't find anything about the documenting the option array
 there.  It would be great to start by opening an issue describing the
 change. I believe there may be other opportunities to improve inline docs,
 especially arrays, elsewhere in the project.

 Marking this ticket as future release for now, until we get the changes
 merged upstream.

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