Update generating_the_url.md

docs/generating_the_url.md

@@ -11,19 +11,19 @@ Check out the [example](#example) at the end of this guide.
 
 ## Signature
 
-Signature protects your URL from being altered by an attacker. It is highly recommended to sign imgproxy URLs in production.
+A signature protects your URL from being altered by an attacker. It is highly recommended to sign imgproxy URLs when imgproxy is being used in production.
 
-Once you set up your [URL signature](configuration.md#url-signature), check out the [Signing the URL](signing_the_url.md) guide to know how to sign your URLs. Otherwise, use any string here.
+Once you set up your [URL signature](configuration.md#url-signature), check out the [Signing the URL](signing_the_url.md) guide to find out how to sign your URLs. Otherwise, since the signature still needs to be present, feel free to use any string here.
 
 ## Processing options
 
-Processing options should be specified as URL parts divided by slashes (`/`). Processing option has the following format:
+Processing options should be specified as URL parts divided by slashes (`/`). A processing option has the following format:
 
 ```
 %option_name:%argument1:%argument2:...:argumentN
 ```
 
-The list of processing options does not define imgproxy's processing pipeline. Instead, imgproxy already comes with a specific, built-in image processing pipeline for the maximum performance. Read more about it in the [About processing pipeline](about_processing_pipeline.md) guide.
+The list of processing options does not define imgproxy's processing pipeline. Instead, imgproxy already comes with a specific, built-in image processing pipeline for maximum performance. Read more about this in the [About processing pipeline](about_processing_pipeline.md) guide.
 
 imgproxy supports the following processing options:
 
@@ -34,7 +34,7 @@ resize:%resizing_type:%width:%height:%enlarge:%extend
 rs:%resizing_type:%width:%height:%enlarge:%extend
 ```
 
-Meta-option that defines the [resizing type](#resizing-type), [width](#width), [height](#height), [enlarge](#enlarge), and [extend](#extend). All arguments are optional and can be omitted to use their default values.
+This is a meta-option that defines the [resizing type](#resizing-type), [width](#width), [height](#height), [enlarge](#enlarge), and [extend](#extend). All arguments are optional and can be omitted to use their default values.
 
 ### Size
 
@@ -43,7 +43,7 @@ size:%width:%height:%enlarge:%extend
 s:%width:%height:%enlarge:%extend
 ```
 
-Meta-option that defines the [width](#width), [height](#height), [enlarge](#enlarge), and [extend](#extend). All arguments are optional and can be omitted to use their default values.
+This is a meta-option that defines the [width](#width), [height](#height), [enlarge](#enlarge), and [extend](#extend). All arguments are optional and can be omitted to use their default values.
 
 ### Resizing type
 
@@ -54,10 +54,10 @@ rt:%resizing_type
 
 Defines how imgproxy will resize the source image. Supported resizing types are:
 
-* `fit`: resizes the image while keeping aspect ratio to fit given size;
-* `fill`: resizes the image while keeping aspect ratio to fill given size and cropping projecting parts;
-* `fill-down`: <i class='badge badge-v3'></i> same as `fill`, but if the resized image is smaller than the requested size, imgproxy will crop the result to keep the requested aspect ratio;
-* `force`: resizes the image without keeping aspect ratio;
+* `fit`: resizes the image while keeping aspect ratio to fit a given size.
+* `fill`: resizes the image while keeping aspect ratio to fill a given size and crops projecting parts.
+* `fill-down`: <i class='badge badge-v3'></i> the same as `fill`, but if the resized image is smaller than the requested size, imgproxy will crop the result to keep the requested aspect ratio.
+* `force`: resizes the image without keeping the aspect ratio.
 * `auto`: if both source and resulting dimensions have the same orientation (portrait or landscape), imgproxy will use `fill`. Otherwise, it will use `fit`.
 
 Default: `fit`
@@ -80,7 +80,7 @@ width:%width
 w:%width
 ```
 
-Defines the width of the resulting image. When set to `0`, imgproxy will calculate the resulting width using the defined height and source aspect ratio. When set to `0` and rezizing type is `force`, imgproxy will keep the original width.
+Defines the width of the resulting image. When set to `0`, imgproxy will calculate width using the defined height and source aspect ratio. When set to `0` and rezizing type is `force`, imgproxy will keep the original width.
 
 Default: `0`
 
@@ -135,7 +135,7 @@ When set, imgproxy will multiply the image dimensions according to these factors
 
 Can be combined with `width` and `height` options. In this case, imgproxy calculates scale factors for the provided size and then multiplies it with the provided zoom factors.
 
-**📝Note:** Unlike [dpr](#dpr), `zoom` doesn't set `Content-DPR` header in the response.
+**📝Note:** Unlike [dpr](#dpr), `zoom` doesn't set the `Content-DPR` header in the response.
 
 Default: `1`
 
@@ -147,7 +147,7 @@ dpr:%dpr
 
 When set, imgproxy will multiply the image dimensions according to this factor for HiDPI (Retina) devices. The value must be greater than 0.
 
-**📝Note:** `dpr` also sets `Content-DPR` header in the response so the browser can render the image correctly.
+**📝Note:** `dpr` also sets the `Content-DPR` header in the response so the browser can correctly render the image.
 
 Default: `1`
 
@@ -160,7 +160,7 @@ el:%enlarge
 
 When set to `1`, `t` or `true`, imgproxy will enlarge the image if it is smaller than the given size.
 
-Default: false
+Default: `false`
 
 ### Extend
 
@@ -170,7 +170,7 @@ ex:%extend:%gravity
 ```
 
 * When `extend` is set to `1`, `t` or `true`, imgproxy will extend the image if it is smaller than the given size.
-* `gravity` _(optional)_ accepts the same values as [gravity](#gravity) option, except `sm`. When `gravity` is not set, imgproxy will use `ce` gravity without offsets.
+* `gravity` _(optional)_ accepts the same values as the [gravity](#gravity) option, except `sm`. When `gravity` is not set, imgproxy will use `ce` gravity without offsets.
 
 Default: `false:ce:0:0`
 
@@ -181,27 +181,27 @@ gravity:%type:%x_offset:%y_offset
 g:%type:%x_offset:%y_offset
 ```
 
-When imgproxy needs to cut some parts of the image, it is guided by the gravity.
+When imgproxy needs to cut some parts of the image, it is guided by the gravity option.
 
 * `type` - specifies the gravity type. Available values:
-  * `no`: north (top edge);
-  * `so`: south (bottom edge);
-  * `ea`: east (right edge);
-  * `we`: west (left edge);
-  * `noea`: north-east (top-right corner);
-  * `nowe`: north-west (top-left corner);
-  * `soea`: south-east (bottom-right corner);
-  * `sowe`: south-west (bottom-left corner);
-  * `ce`: center.
-* `x_offset`, `y_offset` - (optional) specify gravity offset by X and Y axes.
+  * `no`: north (top edge)
+  * `so`: south (bottom edge)
+  * `ea`: east (right edge)
+  * `we`: west (left edge)
+  * `noea`: north-east (top-right corner)
+  * `nowe`: north-west (top-left corner)
+  * `soea`: south-east (bottom-right corner)
+  * `sowe`: south-west (bottom-left corner)
+  * `ce`: center
+* `x_offset`, `y_offset` - (optional) specifies the gravity offset along the X and Y axes.
 
 Default: `ce:0:0`
 
 **Special gravities**:
 
-* `gravity:sm`: smart gravity. `libvips` detects the most "interesting" section of the image and considers it as the center of the resulting image. Offsets are not applicable here;
+* `gravity:sm`: smart gravity. `libvips` detects the most "interesting" section of the image and considers it as the center of the resulting image. Offsets are not applicable here.
 * `gravity:obj:%class_name1:%class_name2:...:%class_nameN`: <i class='badge badge-pro'></i> <i class='badge badge-v3'></i> object-oriented gravity. imgproxy [detects objects](object_detection.md) of provided classes on the image and calculates the resulting image center using their positions. If class names are omited, imgproxy will use all the detected objects.
-* `gravity:fp:%x:%y`: focus point gravity. `x` and `y` are floating point numbers between 0 and 1 that define the coordinates of the center of the resulting image. Treat 0 and 1 as right/left for `x` and top/bottom for `y`.
+* `gravity:fp:%x:%y`: the gravity focus point . `x` and `y` are floating point numbers between 0 and 1 that define the coordinates of the center of the resulting image. Treat 0 and 1 as right/left for `x` and top/bottom for `y`.
 
 ### Crop
 
@@ -216,7 +216,7 @@ Defines an area of the image to be processed (crop before resize).
   * When `width` or `height` is greater than or equal to `1`, imgproxy treats it as an absolute value.
   * When `width` or `height` is less than `1`, imgproxy treats it as a relative value.
   * When `width` or `height` is set to `0`, imgproxy will use the full width/height of the source image.
-* `gravity` _(optional)_ accepts the same values as [gravity](#gravity) option. When `gravity` is not set, imgproxy will use the value of the [gravity](#gravity) option.
+* `gravity` _(optional)_ accepts the same values as the [gravity](#gravity) option. When `gravity` is not set, imgproxy will use the value of the [gravity](#gravity) option.
 
 ### Trim
 
@@ -228,17 +228,17 @@ t:%threshold:%color:%equal_hor:%equal_ver
 Removes surrounding background.
 
 * `threshold` - color similarity tolerance.
-* `color` - _(optional)_ hex-coded value of the color that needs to be cut off.
-* `equal_hor` - _(optional)_ set to `1`, `t` or `true`, imgproxy will cut only equal parts from left and right sides. That means that if 10px of background can be cut off from left and 5px from right then 5px will be cut off from both sides. For example, it can be useful if objects on your images are centered but have non-symmetrical shadow.
+* `color` - _(optional)_ a hex-coded value of the color that needs to be cut off.
+* `equal_hor` - _(optional)_ set to `1`, `t` or `true`, imgproxy will cut only equal parts from left and right sides. That means that if 10px of background can be cut off from the left and 5px from the right, then 5px will be cut off from both sides. For example, this can be useful if objects on your images are centered but have non-symmetrical shadow.
 * `equal_ver` - _(optional)_ acts like `equal_hor` but for top/bottom sides.
 
 **⚠️Warning:** Trimming requires an image to be fully loaded into memory. This disables scale-on-load and significantly increases memory usage and processing time. Use it carefully with large images.
 
-**📝Note:** If you know background color of your images then setting it explicitly via `color` will also save some resources because imgproxy won't detect it automatically.
+**📝Note:** If you know background color of your images then setting it explicitly via `color` will also save some resources because imgproxy won't need to automatically detect it.
 
-**📝Note:** Use `color` value of `FF00FF` for trimming transparent background as imgproxy uses magenta as a transparency key.
+**📝Note:** Use a `color` value of `FF00FF` for trimming transparent backgrounds as imgproxy uses magenta as a transparency key.
 
-**📝Note:** Trimming of animated images is not supported.
+**📝Note:** The trimming of animated images is not supported.
 
 ### Padding
 
@@ -247,16 +247,16 @@ padding:%top:%right:%bottom:%left
 pd:%top:%right:%bottom:%left
 ```
 
-Defines padding size in css manner. All arguments are optional but at least one dimension must be set. Padded space is filled according to [background](#background) option.
+Defines padding size using CSS-style syntax. All arguments are optional but at least one dimension must be set. Padded space is filled according to the [background](#background) option.
 
-* `top` - top padding (and all other sides if they won't be set explicitly);
-* `right` - right padding (and left if it won't be set explicitly);
-* `bottom` - bottom padding;
-* `left` - left padding.
+* `top` - top padding (and for all other sides if they haven't been explicitly st)
+* `right` - right padding (and left if it hasn't been explicitly set)
+* `bottom` - bottom padding
+* `left` - left padding
 
-**📝Note:** Padding is applied after all image transformations (except watermark) and enlarges generated image which means that if your resize dimensions were 100x200px and you applied `padding:10` option then you will get 120x220px image.
+**📝Note:** Padding is applied after all image transformations (except watermarking) and enlarges the generated image. This means that if your resize dimensions were 100x200px and you applied the `padding:10` option, then you will end up with an image with dimensions of 120x220px.
 
-**📝Note:** Padding follows [dpr](#dpr) option so it will be scaled too if you set it.
+**📝Note:** Padding follows the [dpr](#dpr) option so it will also be scaled if you've set it.
 
 ### Auto Rotate
 
@@ -265,7 +265,7 @@ auto_rotate:%auto_rotate
 ar:%auto_rotate
 ```
 
-When set to `1`, `t` or `true`, imgproxy will automatically rotate images based onon the EXIF Orientation parameter (if available in the image meta data). The orientation tag will be removed from the image anyway. Normally this is controlled by the [IMGPROXY_AUTO_ROTATE](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request.
+When set to `1`, `t` or `true`, imgproxy will automatically rotate images based on the EXIF Orientation parameter (if available in the image meta data). The orientation tag will be removed from the image in all cases. Normally this is controlled by the [IMGPROXY_AUTO_ROTATE](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request.
 
 ### Rotate
 
@@ -276,7 +276,7 @@ rot:%angle
 
 Rotates the image on the specified angle. The orientation from the image metadata is applied before the rotation unless autorotation is disabled.
 
-**📝Note:** Only 0/90/180/270/etc degrees angles are supported.
+**📝Note:** Only 0, 90, 180, 270, etc., degree angles are supported.
 
 Default: 0
 
@@ -290,7 +290,7 @@ background:%hex_color
 bg:%hex_color
 ```
 
-When set, imgproxy will fill the resulting image background with the specified color. `R`, `G`, and `B` are red, green and blue channel values of the background color (0-255). `hex_color` is a hex-coded value of the color. Useful when you convert an image with alpha-channel to JPEG.
+When set, imgproxy will fill the resulting image background with the specified color. `R`, `G`, and `B` are the red, green and blue channel values of the background color (0-255). `hex_color` is a hex-coded value of the color. Useful when you convert an image with alpha-channel to JPEG.
 
 With no arguments provided, disables any background manipulations.
 
@@ -303,7 +303,7 @@ background_alpha:%alpha
 bga:%alpha
 ```
 
-Adds alpha channel to `background`. `alpha` is a positive floating point number between `0` and `1`.
+Adds an alpha channel to `background`. The value of `alpha` is a positive floating point number between `0` and `1`.
 
 Default: 1
 
@@ -314,7 +314,7 @@ adjust:%brightness:%contrast:%saturation
 a:%brightness:%contrast:%saturation
 ```
 
-Meta-option that defines the [brightness](#brightness), [contrast](#contrast), and [saturation](#saturation). All arguments are optional and can be omitted to use their default values.
+This is a meta-option that defines the [brightness](#brightness), [contrast](#contrast), and [saturation](#saturation). All arguments are optional and can be omitted to use their default values.
 
 ### Brightness<i class='badge badge-pro'></i> :id=brightness
 
@@ -323,7 +323,7 @@ brightness:%brightness
 br:%brightness
 ```
 
-When set, imgproxy will adjust brightness of the resulting image. `brightness` is an integer number in range from `-255` to `255`.
+When set, imgproxy will adjust brightness of the resulting image. `brightness` is an integer number ranging from `-255` to `255`.
 
 Default: 0
 
@@ -334,7 +334,7 @@ contrast:%contrast
 co:%contrast
 ```
 
-When set, imgproxy will adjust contrast of the resulting image. `contrast` is a positive floating point number, where `1` keeps the contrast unchanged.
+When set, imgproxy will adjust the contrast of the resulting image. `contrast` is a positive floating point number, where a value of `1` leaves the contrast unchanged.
 
 Default: 1
 
@@ -345,7 +345,7 @@ saturation:%saturation
 sa:%saturation
 ```
 
-When set, imgproxy will adjust saturation of the resulting image. `saturation` is a positive floating point number, where `1` keeps the saturation unchanged.
+When set, imgproxy will adjust saturation of the resulting image. `saturation` is a positive floating-point number, where a value of `1` leaves the saturation unchanged.
 
 Default: 1
 
@@ -356,7 +356,7 @@ blur:%sigma
 bl:%sigma
 ```
 
-When set, imgproxy will apply the gaussian blur filter to the resulting image. `sigma` defines the size of a mask imgproxy will use.
+When set, imgproxy will apply a gaussian blur filter to the resulting image. The value of `sigma` defines the size of the mask imgproxy will use.
 
 Default: disabled
 
@@ -367,7 +367,7 @@ sharpen:%sigma
 sh:%sigma
 ```
 
-When set, imgproxy will apply the sharpen filter to the resulting image. `sigma` the size of a mask imgproxy will use.
+When set, imgproxy will apply the sharpen filter to the resulting image. The valoe of `sigma` defines the size of the mask imgproxy will use.
 
 As an approximate guideline, use 0.5 sigma for 4 pixels/mm (display resolution), 1.0 for 12 pixels/mm and 1.5 for 16 pixels/mm (300 dpi == 12 pixels/mm).
 
@@ -380,7 +380,7 @@ pixelate:%size
 pix:%size
 ```
 
-When set, imgproxy will apply the pixelate filter to the resulting image. `size` is the size of a pixel.
+When set, imgproxy will apply the pixelate filter to the resulting image. The value of `size` defines individual pixel size.
 
 Default: disabled
 
@@ -400,9 +400,9 @@ blur_detections:%sigma:%class_name1:%class_name2:...:%class_nameN
 bd:%sigma:%class_name1:%class_name2:...:%class_nameN
 ```
 
-imgproxy [detects objects](object_detection.md) of provided classes and blus them. If class names are omitted, imgproxy blurs all the detected objects.
+imgproxy [detects objects](object_detection.md) of the provided classes and blurs them. If class names are omitted, imgproxy blurs all the detected objects.
 
-`sigma` defines the size of a mask imgproxy will use.
+The value of `sigma` defines the size of the mask imgproxy will use.
 
 ### Draw detections<i class='badge badge-pro'></i><i class='badge badge-v3'></i> :id=draw-detections
 
@@ -411,7 +411,7 @@ draw_detections:%draw:%class_name1:%class_name2:...:%class_nameN
 dd:%draw:%class_name1:%class_name2:...:%class_nameN
 ```
 
-When `draw` is set to `1`, `t` or `true`, imgproxy [detects objects](object_detection.md) of provided classes and draws their bounding boxed. If class names are omitted, imgproxy draws the bounding boxes of all the detected objects.
+When `draw` is set to `1`, `t` or `true`, imgproxy [detects objects](object_detection.md) of the provided classes and draws their bounding boxes. If class names are omitted, imgproxy draws the bounding boxes of all the detected objects.
 
 ### Watermark
 
@@ -420,22 +420,22 @@ watermark:%opacity:%position:%x_offset:%y_offset:%scale
 wm:%opacity:%position:%x_offset:%y_offset:%scale
 ```
 
-Puts watermark on the processed image.
+Places a watermark on the processed image.
 
-* `opacity` - watermark opacity modifier. Final opacity is calculated like `base_opacity * opacity`.
-* `position` - (optional) specifies the position of the watermark. Available values:
-  * `ce`: (default) center;
-  * `no`: north (top edge);
-  * `so`: south (bottom edge);
-  * `ea`: east (right edge);
-  * `we`: west (left edge);
-  * `noea`: north-east (top-right corner);
-  * `nowe`: north-west (top-left corner);
-  * `soea`: south-east (bottom-right corner);
-  * `sowe`: south-west (bottom-left corner);
-  * `re`: replicate watermark to fill the whole image;
-* `x_offset`, `y_offset` - (optional) specify watermark offset by X and Y axes. For `re` position, define spacing between tiles;
-* `scale` - (optional) floating point number that defines watermark size relative to the resulting image size. When set to `0` or omitted, watermark size won't be changed.
+* `opacity`: watermark opacity modifier. Final opacity is calculated like `base_opacity * opacity`.
+* `position`: (optional) specifies the position of the watermark. Available values:
+  * `ce`: (default) center
+  * `no`: north (top edge)
+  * `so`: south (bottom edge)
+  * `ea`: east (right edge)
+  * `we`: west (left edge)
+  * `noea`: north-east (top-right corner)
+  * `nowe`: north-west (top-left corner)
+  * `soea`: south-east (bottom-right corner)
+  * `sowe`: south-west (bottom-left corner)
+  * `re`: replicate watermark to fill the whole image
+* `x_offset`, `y_offset` - (optional) specify watermark offset by X and Y axes. Not applicable to `re` position.
+* `scale`: (optional) a floating-point number that defines the watermark size relative to the resultant image size. When set to `0` or when omitted, the watermark size won't be changed.
 
 Default: disabled
 
@@ -446,7 +446,7 @@ watermark_url:%url
 wmu:%url
 ```
 
-When set, imgproxy will use the image from the specified URL as a watermark. `url` is Base64-encoded URL of the custom watermark.
+When set, imgproxy will use the image from the specified URL as a watermark. `url` is the Base64-encoded URL of the custom watermark.
 
 Default: blank
 
@@ -457,11 +457,11 @@ watermark_text:%text
 wmt:%text
 ```
 
-When set, imgproxy will generate image from the provided text and use it as a watermark. `text` is Base64-encoded text of the custom watermark.
+When set, imgproxy will generate an image from the provided text and use it as a watermark. `text` is the Base64-encoded text of the custom watermark.
 
-By default, text color is black and font is `sans 16`. You can use [Pango markup](https://docs.gtk.org/Pango/pango_markup.html) in the `text` value to change the style.
+By default, the text color is black and the font is `sans 16`. You can use [Pango markup](https://docs.gtk.org/Pango/pango_markup.html) in the `text` value to change the style.
 
-If you want to use your custom font, you need to put it to `/usr/share/fonts` inside a contsainer.
+If you want to use a custom font, you need to put it in `/usr/share/fonts` inside a container.
 
 Default: blank
 
@@ -472,7 +472,7 @@ style:%style
 st:%style
 ```
 
-When set, imgproxy will prepend `<style>` node with provided content to the `<svg>` node of source SVG image. `%style` is url-safe Base64-encoded CSS-style.
+When set, imgproxy will prepend a `<style>` node with the provided content to the `<svg>` node of a source SVG image. `%style` is url-safe Base64-encoded CSS-styles.
 
 Default: blank
 
@@ -483,7 +483,7 @@ strip_metadata:%strip_metadata
 sm:%strip_metadata
 ```
 
-When set to `1`, `t` or `true`, imgproxy will strip the metadata (EXIF, IPTC, etc.) on JPEG and WebP output images. Normally this is controlled by the [IMGPROXY_STRIP_METADATA](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request.
+When set to `1`, `t` or `true`, imgproxy will strip the metadata (EXIF, IPTC, etc.) on JPEG and WebP output images. This is normally controlled by the [IMGPROXY_STRIP_METADATA](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request.
 
 ### Strip Color Profile
 
@@ -492,7 +492,7 @@ strip_color_profile:%strip_color_profile
 scp:%strip_color_profile
 ```
 
-When set to `1`, `t` or `true`, imgproxy will transform the embedded color profile (ICC) to sRGB and remove it from the image. Otherwise, imgproxy will try to keep it as is. Normally this is controlled by the [IMGPROXY_STRIP_COLOR_PROFILE](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request.
+When set to `1`, `t` or `true`, imgproxy will transform the embedded color profile (ICC) to sRGB and remove it from the image. Otherwise, imgproxy will try to keep it as is. This is normally controlled by the [IMGPROXY_STRIP_COLOR_PROFILE](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request.
 
 ### Quality
 
@@ -501,7 +501,7 @@ quality:%quality
 q:%quality
 ```
 
-Redefines quality of the resulting image, percentage. When `0`, quality is assumed based on `IMGPROXY_QUALITY` and [format_quality](#format-quality).
+Redefines quality of the resulting image, as a percentage. When set to `0`, quality is assumed based on `IMGPROXY_QUALITY` and [format_quality](#format-quality).
 
 Default: 0.
 
@@ -532,11 +532,11 @@ max_bytes:%bytes
 mb:%bytes
 ```
 
-When set, imgproxy automatically degrades the quality of the image until the image is under the specified amount of bytes.
+When set, imgproxy automatically degrades the quality of the image until the image size is under the specified amount of bytes.
 
 **📝Note:** Applicable only to `jpg`, `webp`, `heic`, and `tiff`.
 
-**⚠️Warning:** When `max_bytes` is set, imgproxy saves image multiple times to achieve specified image size.
+**⚠️Warning:** When `max_bytes` is set, imgproxy saves image multiple times to achieve the specified image size.
 
 Default: 0
 
@@ -547,7 +547,7 @@ jpeg_options:%progressive:%no_subsample:%trellis_quant:%overshoot_deringing:%opt
 jpgo:%progressive:%no_subsample:%trellis_quant:%overshoot_deringing:%optimize_scans:%quant_table
 ```
 
-Allows redefining JPEG saving options. All arguments have the same meaning as [Advanced JPEG compression](configuration.md#advanced-jpeg-compression) configs. All arguments are optional and can be omitted.
+Allows redefining JPEG saving options. All arguments have the same meaning as the [Advanced JPEG compression](configuration.md#advanced-jpeg-compression) configs. All arguments are optional and can be omitted.
 
 ### PNG options<i class='badge badge-pro'></i> :id=png-options
 
@@ -556,7 +556,7 @@ png_options:%interlaced:%quantize:%quantization_colors
 pngo:%interlaced:%quantize:%quantization_colors
 ```
 
-Allows redefining PNG saving options. All arguments have the same meaning as [Advanced PNG compression](configuration.md#advanced-png-compression) configs. All arguments are optional and can be omitted.
+Allows redefining PNG saving options. All arguments have the same meaning as with the [Advanced PNG compression](configuration.md#advanced-png-compression) configs. All arguments are optional and can be omitted.
 
 ### GIF options<i class='badge badge-pro'></i> :id=gif-options
 
@@ -565,7 +565,7 @@ gif_options:%optimize_frames:%optimize_transparency
 gifo:%optimize_frames:%optimize_transparency
 ```
 
-Allows redefining GIF saving options. All arguments have the same meaning as [Advanced GIF compression](configuration.md#advanced-gif-compression) configs. All arguments are optional and can be omitted.
+Allows redefining GIF saving options. All arguments have the same meaning as with the [Advanced GIF compression](configuration.md#advanced-gif-compression) configs. All arguments are optional and can be omitted.
 
 ### Format
 
@@ -575,7 +575,7 @@ f:%extension
 ext:%extension
 ```
 
-Specifies the resulting image format. Alias for [extension](#extension) URL part.
+Specifies the resulting image format. Alias for the [extension](#extension) part of the URL.
 
 Default: `jpg`
 
@@ -586,7 +586,7 @@ page:%page
 pg:%page
 ```
 
-When source image supports pagination (PDF, TIFF) or animation (GIF, WebP), this option allows specifying the page to use. Pages numeration starts from zero.
+When a source image supports pagination (PDF, TIFF) or animation (GIF, WebP), this option allows specifying the page to use it on. Page numeration starts from zero.
 
 Default: 0
 
@@ -601,14 +601,14 @@ Allows redefining `IMGPROXY_VIDEO_THUMBNAIL_SECOND` config.
 
 ### Fallback image URL<i class='badge badge-pro'></i><i class='badge badge-v3'></i> :id=fallback-image-url
 
-You can use a custom fallback image specifying its URL with `fallback_image_url` processing option:
+You can use a custom fallback image by specifying its URL with the `fallback_image_url` processing option:
 
 ```
 fallback_image_url:%url
 fiu:%url
 ```
 
-Where `url` is Base64-encoded URL of the custom fallback image.
+The value of `url` is the Base64-encoded URL of the custom fallback image.
 
 Default: blank
 
@@ -619,9 +619,9 @@ skip_processing:%extension1:%extension2:...:%extensionN
 skp:%extension1:%extension2:...:%extensionN
 ```
 
-When set, imgproxy will skip the processing of listed formats. Also available as [IMGPROXY_SKIP_PROCESSING_FORMATS](configuration.md#skip-processing) configuration.
+When set, imgproxy will skip the processing of the listed formats. Also available as the [IMGPROXY_SKIP_PROCESSING_FORMATS](configuration.md#skip-processing) configuration.
 
-**📝Note:** Processing can be skipped only when the requested format is the same as the source format.
+**📝Note:** Processing can only be skipped when the requested format is the same as the source format.
 
 **📝Note:** Video thumbnail processing can't be skipped.
 
@@ -634,9 +634,9 @@ cachebuster:%string
 cb:%string
 ```
 
-Cache buster doesn't affect image processing but it's changing allows to bypass CDN, proxy server and browser cache. Useful when you have changed some things that are not reflected in the URL like image quality settings, presets or watermark data.
+Cache buster doesn't affect image processing but it's changing allows for bypassing the CDN, proxy server and browser cache. Useful when you have changed some things that are not reflected in the URL, like image quality settings, presets, or watermark data.
 
-It's highly recommended to prefer `cachebuster` option over URL query string because the option can be properly signed.
+It's highly recommended to prefer the `cachebuster` option over a URL query string because that option can be properly signed.
 
 Default: empty
 
@@ -647,7 +647,7 @@ expires:%timestamp
 exp:%timestamp
 ```
 
-When set, imgproxy will check provided unix timestamp and return 404 when expired.
+When set, imgproxy will check the provided unix timestamp and return 404 when expired.
 
 Default: empty
 
@@ -658,7 +658,7 @@ filename:%string
 fn:%string
 ```
 
-Defines a filename for `Content-Disposition` header. When not specified, imgproxy will get filename from the source url.
+Defines a filename for the `Content-Disposition` header. When not specified, imgproxy will get the filename from the source url.
 
 Default: empty
 
@@ -677,19 +677,19 @@ Default: empty
 
 ## Source URL
 
-There are two ways to specify source url:
+There are two ways to specify the source url:
 
 ### Plain
 
-The source URL can be provided as is, prendended by `/plain/` part:
+The source URL can be provided as is, prendended by the `/plain/` segment:
 
 ```
 /plain/http://example.com/images/curiosity.jpg
 ```
 
-**📝Note:** If the source URL contains query string or `@`, you need to escape it.
+**📝Note:** If the source URL contains a query string or `@`, you'll need to escape it.
 
-When using plain source URL, you can specify the [extension](#extension) after `@`:
+When using a plain source URL, you can specify the [extension](#extension) after `@`:
 
 ```
 /plain/http://example.com/images/curiosity.jpg@png
@@ -697,13 +697,13 @@ When using plain source URL, you can specify the [extension](#extension) after `
 
 ### Base64 encoded
 
-The source URL can be encoded with URL-safe Base64. The encoded URL can be split with `/` for your needs:
+The source URL can be encoded with URL-safe Base64. The encoded URL can be split with `/` as desired:
 
 ```
 /aHR0cDovL2V4YW1w/bGUuY29tL2ltYWdl/cy9jdXJpb3NpdHku/anBn
 ```
 
-When using encoded source URL, you can specify the [extension](#extension) after `.`:
+When using an encoded source URL, you can specify the [extension](#extension) after `.`:
 
 ```
 /aHR0cDovL2V4YW1w/bGUuY29tL2ltYWdl/cy9jdXJpb3NpdHku/anBn.png
@@ -711,13 +711,13 @@ When using encoded source URL, you can specify the [extension](#extension) after
 
 ## Extension
 
-Extension specifies the format of the resulting image. Read about image formats support [here](image_formats_support.md).
+Extension specifies the format of the resulting image. Read more about image formats support [here](image_formats_support.md).
 
-The extension part can be omitted. In this case, imgproxy will use source image format as resulting one. If source image format is not supported as resulting, imgproxy will use `jpg`. You also can [enable WebP support detection](configuration.md#webp-support-detection) to use it as default resulting format when possible.
+The extension can be omitted. In this case, imgproxy will use the source image format as resulting one. If the source image format is not supported as the resulting image, imgproxy will use `jpg`. You also can [enable WebP support detection](configuration.md#webp-support-detection) to use it as the default resulting format when possible.
 
 ## Example
 
-Signed imgproxy URL that uses `sharp` preset, resizes `http://example.com/images/curiosity.jpg` to fill `300x400` area with smart gravity without enlarging, and then converts the image to `png`:
+A signed imgproxy URL that uses the `sharp` preset, resizes `http://example.com/images/curiosity.jpg` to fill a `300x400` area using smart gravity without enlarging, and then converts the image to `png`:
 
 ```
 http://imgproxy.example.com/AfrOrF3gWeDA6VOlDG4TzxMv39O7MXnF4CXpKUwGqRM/preset:sharp/resize:fill:300:400:0/gravity:sm/plain/http://example.com/images/curiosity.jpg@png
@@ -729,7 +729,7 @@ The same URL with shortcuts will look like this:
 http://imgproxy.example.com/AfrOrF3gWeDA6VOlDG4TzxMv39O7MXnF4CXpKUwGqRM/pr:sharp/rs:fill:300:400:0/g:sm/plain/http://example.com/images/curiosity.jpg@png
 ```
 
-The same URL with Base64-encoded source URL will look like this:
+The same URL with a Base64-encoded source URL will look like this:
 
 ```
 http://imgproxy.example.com/AfrOrF3gWeDA6VOlDG4TzxMv39O7MXnF4CXpKUwGqRM/pr:sharp/rs:fill:300:400:0/g:sm/aHR0cDovL2V4YW1w/bGUuY29tL2ltYWdl/cy9jdXJpb3NpdHku/anBn.png