Fixing face cropping documentation

Author: deven96

src/content/partials/images/gravity.mdx

@@ -4,7 +4,8 @@
 
 import { Tabs, TabItem } from "~/components";
 
-When cropping with `fit: "cover"` and `fit: "crop"`, this parameter defines the side or point that should not be cropped. Available options are:
+Specifies how an image should be cropped when used with `fit=cover` and `fit=crop`.
+Available options are `auto`, `face`, a side (`left`, `right`, `top`, `bottom`), and relative coordinates (`XxY` with a valid range of `0.0` to `1.0`):
 
 - `auto`\
   Selects focal point based on saliency detection (using maximum symmetric surround algorithm).
@@ -18,7 +19,8 @@ You must subtract the height of the image before you calculate the focal point.
 :::
 
 - `face`\
-	Selects focal point based on face detection (with minimum bounding box surounding all faces within the image). Only works with `fit: "crop"` and falls back to the center of the image as focalpoint if face(s) are not found.
+	Automatically sets the focal point based on detected faces in an image. This can be combined with the `zoom` parameter to specify how closely the image should be cropped towards the faces.
+	The new focal point is determined by a minimum bounding box that surrounds all detected faces. If no faces are found, then the focal point will fall back to the center of the image.
 
 <Tabs>
   <TabItem label="URL format">

src/content/partials/images/zoom.mdx

@@ -3,10 +3,10 @@
 ---
 import { Tabs, TabItem } from "~/components"
 
-Used alongside `gravity: "face"` and `fit: "crop"` to control the zoom level.
+Specifis how closely the image is cropped toward the face when combined with the `gravity=face` option.
+Valid range is from `0` (includes as much of the background as possible) to `1` (crops the image as closely to the face as possible), decimals allowed. The default is `0`.
 
-Valid options range from 0 to 1 where 0 should return the entire image and 1 should return only the face.
-Only takes effect if face(s) are found.
+This controls the threshold for how much of the surrounding pixels around the face will be included in the image and takes effect only if face(s) are detected in the image.
 
 <Tabs>
   <TabItem label="URL format">