- * @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'.
+ *
+ * @type array $size {
+ * @type int $width Image width.
+ * @type int $height Image height.
+ * @type bool $crop Optional. Whether to crop the image. Default false.
+ * }
+ * }
+ * @return array An array of resized images metadata by size.