[wp-trac] [WordPress Trac] #42782: wp_rand() should have inline docs to describe its purpose

[WordPress Trac]

#42782: wp_rand() should have inline docs to describe its purpose
----------------------------+---------------------------
 Reporter:  webdevmattcrom  |       Owner:  DrewAPicture
     Type:  enhancement     |      Status:  closed
 Priority:  normal          |   Milestone:  5.0
Component:  General         |     Version:
 Severity:  normal          |  Resolution:  fixed
 Keywords:  has-patch       |     Focuses:  docs
----------------------------+---------------------------

Comment (by webdevmattcrom):

 @DrewAPicture regarding "enhancement" versus "bug" again, I can definitely
 see from the WordPress Core perspective that it's a mere enhancement. But
 without a description, the DevHub page for this function has a blank
 Description. It's a good question in general in terms of where to draw the
 line between Core and DevHub completeness, but the purpose of DocBlocks
 shouldn't necessarily be seen only as an enhancement IMHO. Of course, in
 this case there is not a LACK of a DocBlock, simply that it's incomplete
 as-is.

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