- * @param array $sizes { {'width'=>int, 'height'=>int, 'crop'=>bool}, ... }
- * @return array
+ * @param array $sizes {
+ * An array of image size arrays. Default sizes are 'small', 'medium', 'large'.
+ *
+ * Either a height or width must be provided.
+ * If one of the two is set to null, the resize will
+ * maintain aspect ratio according to the provided dimension.
+ *
+ * @type array $size {
+ * @type int ['width'] Optional. Image width.
+ * @type int ['height'] Optional. Image height.
+ * @type bool ['crop'] Optional. Whether to crop the image. Default false.
+ * }
+ * }
+ * @return array An array of resized images' metadata by size.