content: Updates for v0.155.0

Closes gohugoio#3347

Author: jmooring

.cspell.json

@@ -181,6 +181,7 @@
     "dring",
     "fleqn",
     "inor",
+    "iptc",
     "jausten",
     "jdoe",
     "jsmith",

.markdownlint-cli2.yaml

@@ -80,7 +80,7 @@ config:
     url_inline: false
   MD055:
     style: consistent
-  MD056: true
+  MD056: false # interferes with Markdown attributes
   # MD057 deprecated
   MD058: true
   MD059:

content/en/_common/methods/resource/processing-spec.md

@@ -10,14 +10,14 @@ action
 : Specify one of `crop`, `fill`, `fit`, or `resize`. This is applicable to the [`Process`][] method and the [`images.Process`][] filter. If you specify an action, you must also provide dimensions.
 
 anchor
-: The focal point of the crop box when cropping or filling an image. Valid options include `TopLeft`, `Top`, `TopRight`, `Left`, `Center`, `Right`, `BottomLeft`, `Bottom`, `BottomRight`, or `Smart`. This defaults to the [`anchor`][] parameter in your site configuration. The `Smart` option identifies the most interesting area of the image based on the smart cropping algorithm implemented in the [`smartcrop.js`][] library.
+: The focal point used when cropping or filling an image. Valid options include `TopLeft`, `Top`, `TopRight`, `Left`, `Center`, `Right`, `BottomLeft`, `Bottom`, `BottomRight`, or `Smart`. The `Smart` option utilizes the [`smartcrop.js`][] library to identify the most interesting area of the image. This defaults to the [`anchor`][] parameter in your site configuration.
 
 background color
-: The background color of the resulting image. This applies when converting an image with transparency to a format that does not support it, such as when converting from PNG to JPEG, or when rotating an image by a non-orthogonal angle into a non-transparent format. In these cases, this color fills the empty space created as the image extents increase to fit the rotated corners. The value must be an RGB [hexadecimal color][], defaulting to the [`bgColor`][] parameter in your site configuration.
+: The background color used when converting transparent images to formats that do not support transparency, such as PNG to JPEG. This color also fills the empty space created when rotating an image by a non-orthogonal angle if the space is not transparent and a background color is not specified in the  processing specification. The value must be an RGB [hexadecimal color][]. This defaults to the [`bgColor`][] parameter in your site configuration.
 
 compression
 : {{< new-in 0.153.5 />}}
-: The compression method used when encoding an image. Valid options include `lossless` or `lossy`. The `lossless` method is only applicable to WebP images. This defaults to the [`compression`][] parameter in your site configuration.
+: The encoding strategy used for the image. Options are `lossy` or `lossless`. Note that `lossless` is only supported by the WebP format. This defaults to the [`compression`][] parameter in your site configuration.
 
 dimensions
 : The dimensions of the resulting image, in pixels. The format is `WIDTHxHEIGHT` where `WIDTH` and `HEIGHT` are whole numbers. When resizing an image, you may specify only the width (such as `600x`) or only the height (such as `x400`) for proportional scaling. Specifying both width and height when resizing an image may result in non-proportional scaling. When cropping, fitting, or filling, you must provide both width and height such as `600x400`.
@@ -26,7 +26,7 @@ format
 : The format of the resulting image. Valid options include `bmp`, `gif`, `jpeg`, `png`, `tiff`, or `webp`. This defaults to the format of the source image.
 
 hint
-: The encoding preset used when processing WebP images, equivalent to the `-preset` flag for the [`cwebp`][] encoder. Valid options include `drawing`, `icon`, `photo`, `picture`, or `text`. This defaults to the [`hint`][] parameter in your site configuration.
+: The encoding preset used when processing WebP images, equivalent to the `-preset` flag for the [`cwebp`][] CLI. Valid options include `drawing`, `icon`, `photo`, `picture`, or `text`. This defaults to the [`hint`][] parameter in your site configuration.
 
   Value|Example
   :--|:--
@@ -37,10 +37,10 @@ hint
   `text`|Image that is primarily text
 
 quality
-: The quality of the resulting image, applicable to JPEG and WebP images when using  lossy [compression](#compression). The format is `qQUALITY` where `QUALITY` is a whole number between `1` and `100`, inclusive. This defaults to the [`quality`][] parameter in your site configuration.
+: The visual fidelity of the image, applicable to JPEG and WebP formats when using `lossy` compression. The format is `qQUALITY` where `QUALITY` is a whole number between `1` and `100`, inclusive. Lower numbers prioritize smaller file size, while higher numbers prioritize visual clarity. This defaults to the [`quality`][] parameter in your site configuration.
 
 resampling filter
-: The filter used to calculate new pixels when resizing, fitting, or filling an image. Common options include `box`, `lanczos`, `catmullRom`, `mitchellNetravali`, `linear`, or `nearestNeighbor`. This defaults to the [`resampleFilter`][] parameter in your site configuration.
+: The algorithm used to calculate new pixels when resizing, fitting, or filling an image. Common options include `box`, `lanczos`, `catmullRom`, `mitchellNetravali`, `linear`, or `nearestNeighbor`. This defaults to the [`resampleFilter`][] parameter in your site configuration.
 
   Filter|Description
   :--|:--
@@ -54,20 +54,20 @@ resampling filter
   Refer to the [source documentation][] for a complete list of available resampling filters. If you wish to improve image quality at the expense of performance, you may wish to experiment with the alternative filters.
 
 rotation
-: The number of whole degrees to rotate an image counter-clockwise. The format is `rDEGREES` where `DEGREES` is a whole number. Hugo performs rotation before any other transformations, so your target dimensions and any anchor point should refer to the image orientation after rotation. Use `r90`, `r180`, or `r270` for orthogonal rotations, or arbitrary angles such as `r45`. To rotate clockwise, use a negative number such as `r-45`. To automatically rotate an image based on its EXIF orientation tag, use the [`images.AutoOrient`][] filter instead of manual rotation.
+: The number of whole degrees to rotate an image counter-clockwise. The format is `rDEGREES` where `DEGREES` is a whole number. Hugo performs rotation before any other transformations, so your [target dimensions](#dimensions) and any [anchor](#anchor) should refer to the image orientation after rotation. Use `r90`, `r180`, or `r270` for orthogonal rotations, or arbitrary angles such as `r45`. To rotate clockwise, use a negative number such as `r-45`. To automatically rotate an image based on its Exif orientation tag, use the [`images.AutoOrient`][] filter instead of manual rotation.
 
-  Rotating by non-orthogonal values increases the image extents to fit the rotated corners; the resulting empty space is transparent for formats supporting alpha channels, or filled with a background color. This background color defaults to the [`bgColor`][] parameter in your site configuration unless you include a [background color](#background-color)
+  Rotating by non-orthogonal values increases the image extents to fit the rotated corners. For formats supporting alpha channels such as PNG or WebP, this resulting empty space is transparent by default. If the target format does not support transparency such as JPEG, or if you explicitly specify a [background color](#background-color) in the processing specification, the space is filled. If a color is required but not specified in the processing string, it defaults to the [`bgColor`][] parameter in your site configuration.
 
-[`anchor`]: /configuration/imaging/#processing-options
-[`bgcolor`]: /configuration/imaging/#processing-options
-[`compression`]: /configuration/imaging/#processing-options
+[`anchor`]: /configuration/imaging/#anchor
+[`bgcolor`]: /configuration/imaging/#bgcolor
+[`compression`]: /configuration/imaging/#compression
 [`cwebp`]: https://developers.google.com/speed/webp/docs/cwebp
-[`hint`]: /configuration/imaging/#processing-options
+[`hint`]: /configuration/imaging/#hint
 [`images.AutoOrient`]: /functions/images/autoorient/
 [`images.Process`]: /functions/images/process/
 [`Process`]: /methods/resource/process
-[`quality`]: /configuration/imaging/#processing-options
-[`resampleFilter`]: /configuration/imaging/#processing-options
+[`quality`]: /configuration/imaging/#quality
+[`resampleFilter`]: /configuration/imaging/#resamplefilter
 [`smartcrop.js`]: https://github.com/jwagner/smartcrop.js
 [hexadecimal color]: https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color
 [source documentation]: https://github.com/disintegration/imaging#image-resizing

content/en/about/features.md

@@ -81,7 +81,7 @@ weight: 20
 ## Asset pipelines
 
 [Image processing]
-: Convert, resize, crop, rotate, adjust colors, apply filters, overlay text and images, and extract EXIF data.
+: Convert, resize, crop, rotate, adjust colors, apply filters, overlay text and images, and extract metadata.
 
 [JavaScript bundling]
 : Transpile TypeScript and JSX to JavaScript, bundle, tree shake, minify, create source maps, and perform SRI hashing.

content/en/configuration/all.md

@@ -148,7 +148,7 @@ ignoreLogs
 : (`[]string`) A slice of message identifiers corresponding to warnings and errors you wish to suppress. See [`erroridf`][] and [`warnidf`][].
 
 ignoreVendorPaths
-: (`string`) A [glob](g) pattern matching the module paths to exclude from the `_vendor` directory.
+: (`string`) A [glob pattern](g) matching the module paths to exclude from the `_vendor` directory.
 
 imaging
 : See [configure imaging][].

content/en/configuration/caches.md

@@ -10,21 +10,57 @@ This is the default configuration:
 
 {{< code-toggle config=caches />}}
 
+## Purpose
+
+Hugo uses file caches to store data on disk, avoiding repeated operations within the same build and persisting data from one build to the next.
+
+assets
+: Caches processed CSS and Sass resources.
+
+getcsv
+: Caches the results of the [`data.GetCSV`][] function. Note that the `data.GetCSV` function was deprecated in v0.123.0 in favor of the [`resources.GetRemote`][] function.
+
+getjson
+: Caches the results of the [`data.GetJSON`][] function. Note that the `data.GetJSON` function was deprecated in v0.123.0 in favor of the [`resources.GetRemote`][] function.
+
+getresource
+: Caches files fetched from remote URLs via the [`resources.GetRemote`][] function.
+
+images
+: Caches processed images.
+
+misc
+: Caches miscellaneous data.
+
+modulequeries
+: Caches the results of module resolution queries.
+
+modules
+: Caches downloaded modules.
+
 ## Keys
 
 dir
-: (`string`) The absolute file system path where the cached files will be stored. You can begin the path with the `:cacheDir` or `:resourceDir` token. These tokens will be replaced with the actual configured cache directory and resource directory paths, respectively.
+: (`string`) The absolute file system path where Hugo stores the cached files. You can begin the path with the `:cacheDir` or `:resourceDir` [tokens](#tokens) to anchor the cache to specific system or project locations.
 
 maxAge
-: (`string`) The [duration](g) a cached entry remains valid before being evicted. A value of `0` disables the cache. A value of `-1` means the cache entry never expires (the default).
+: (`string`) The duration a cached entry remains valid before being evicted, expressed as a [duration](g). A value of `0` disables the cache for that key, and a value of `-1` means the cache entry never expires. Default is `-1`.
 
 ## Tokens
 
 `:cacheDir`
-: (`string`) The designated cache directory. See&nbsp;[details](/configuration/all/#cachedir).
+: (`string`) The designated cache directory. See [details](/configuration/all/#cachedir).
 
 `:project`
-: (`string`) The base directory name of the current Hugo project. By default, this ensures each project has isolated file caches, so running `hugo --gc` will only affect the current project's cache and not those of other Hugo projects on the same machine.
+: (`string`) The base directory name of the current Hugo project. This ensures isolated file caches for each project, preventing the `hugo --gc` command from affecting other projects on the same machine.
 
 `:resourceDir`
-: (`string`) The designated directory for caching output from [asset pipelines](g). See&nbsp;[details](/configuration/all/#resourcedir).
+: (`string`) The designated directory for caching output from [asset pipelines](g). See [details](/configuration/all/#resourcedir).
+
+## Garbage collection
+
+As you modify your site or change your configuration, cached files from previous builds may remain on disk, consuming unnecessary space. Use the `hugo --gc` command to remove these expired or unused entries from the file cache.
+
+[`data.GetJSON`]: /functions/data/getjson/
+[`data.GetCSV`]: /functions/data/getcsv/
+[`resources.GetRemote`]: /functions/resources/getremote/

content/en/configuration/cascade.md

@@ -40,16 +40,16 @@ path = '{/articles,/articles/**}'
 Use any combination of these keywords to target pages and/or environments:
 
 environment
-: (`string`) A [glob](g) pattern matching the build [environment](g). For example: `{staging,production}`.
+: (`string`) A [glob pattern](g) matching the build [environment](g). For example: `{staging,production}`.
 
 kind
-: (`string`) A [glob](g) pattern matching the [page kind](g). For example: `{taxonomy,term}`.
+: (`string`) A [glob pattern](g) matching the [page kind](g). For example: `{taxonomy,term}`.
 
 lang
-: (`string`) A [glob](g) pattern matching the [page language]. For example: `{en,de}`.
+: (`string`) A [glob pattern](g) matching the [page language]. For example: `{en,de}`.
 
 path
-: (`string`) A [glob](g) pattern matching the page's [logical path](g). For example: `{/books,/books/**}`.
+: (`string`) A [glob pattern](g) matching the page's [logical path](g). For example: `{/books,/books/**}`.
 
 ## Array
 

content/en/configuration/deployment.md

@@ -53,13 +53,13 @@ cloudFrontDistributionID
 : (`string`) The CloudFront Distribution ID, applicable if you are using the Amazon Web Services CloudFront CDN. Hugo will invalidate the CDN when deploying this target.
 
 exclude
-: (`string`) A [glob](g) pattern matching files to exclude when deploying to this target. Local files failing the include/exclude filters are not uploaded, and remote files failing these filters are not deleted.
+: (`string`) A [glob pattern](g) matching files to exclude when deploying to this target. Local files failing the include/exclude filters are not uploaded, and remote files failing these filters are not deleted.
 
 googleCloudCDNOrigin
 : (`string`) The Google Cloud project and CDN origin to invalidate when deploying this target, specified as `<project>/<origin>`.
 
 include
-: (`string`) A [glob](g) pattern matching files to include when deploying to this target. Local files failing the include/exclude filters are not uploaded, and remote files failing these filters are not deleted.
+: (`string`) A [glob pattern](g) matching files to include when deploying to this target. Local files failing the include/exclude filters are not uploaded, and remote files failing these filters are not deleted.
 
 name
 : (`string`) An arbitrary name for this target.

content/en/configuration/http-cache.md

@@ -57,10 +57,10 @@ respectCacheControlNoStoreInResponse
 : (`bool`) Whether to respect the `no-store` directive in the server's `Cache-Control` response header when fetching remote resources via the [`resources.GetRemote`][] function. Default is `false`.
 
 cache.for.excludes
-: (`string`) A list of [glob](g) patterns to exclude from caching. In its default configuration HTTP caching excludes all files.
+: (`[]string`) A slice of [glob patterns](g) to exclude from caching. In its default configuration HTTP caching excludes all files.
 
 cache.for.includes
-: (`string`) A list of [glob](g) patterns to cache.
+: (`[]string`) A slice of [glob patterns](g) to cache.
 
 polls
 : A slice of polling configurations.
@@ -75,10 +75,10 @@ polls.low
 : (`string`) The minimum polling interval expressed as a [duration](g). This is used after a recent change and gradually increases towards `polls.high`. Default is `0s`.
 
 polls.for.excludes
-: (`string`) A list of [glob](g) patterns to exclude from polling for this configuration.
+: (`[]string`) A slice of [glob patterns](g) to exclude from polling for this configuration.
 
 polls.for.includes
-: (`string`) A list of [glob](g) patterns to include in polling for this configuration.
+: (`[]string`) A slice of [glob patterns](g) to include in polling for this configuration.
 
 ## HTTP polling
 
@@ -109,10 +109,10 @@ polls.low
 : (`string`) The minimum polling interval expressed as a [duration](g). This is used after a recent change and gradually increases towards `polls.high`. Default is `0s`.
 
 polls.for.excludes
-: (`string`) A list of [glob](g) patterns to exclude from polling for this configuration.
+: (`[]string`) A list of [glob patterns](g) to exclude from polling for this configuration.
 
 polls.for.includes
-: (`string`) A list of [glob](g) patterns to include in polling for this configuration.
+: (`[]string`) A list of [glob patterns](g) to include in polling for this configuration.
 
 ## Behavior