[wp-trac] [WordPress Trac] #42463: Poor Description of add_image_size Params

[WordPress Trac]

#42463: Poor Description of add_image_size Params
--------------------------+----------------------------------------
 Reporter:  miqrogroove   |      Owner:
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  Media         |    Version:  trunk
 Severity:  normal        |   Keywords:  good-first-bug needs-patch
  Focuses:  docs          |
--------------------------+----------------------------------------
 From https://core.trac.wordpress.org/browser/tags/4.8/src/wp-
 includes/media.php#L274

 {{{
 274      * @param bool|array $crop   Optional. Whether to crop images to
 specified width and height or resize.
 275      *                           An array can specify positioning of
 the crop area. Default false.
 }}}

 So it literally says to do one thing or another.  But which is what?
 "Default false" has a meaning, but it is totally lost in this
 documentation.

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