diff --git a/docs/guides/cache/azblob.md b/docs/guides/cache/azblob.md
index bb1781d2..fd3b10d2 100644
--- a/docs/guides/cache/azblob.md
+++ b/docs/guides/cache/azblob.md
@@ -30,15 +30,15 @@ $ docker buildx build . --push -t <registry>/<image> \
 Common parameters:
 
 - `name`: the name of the cache image.
-
-Parameters for `--cache-to`:
-
 - `account_url`: the base address of the blob storage account, for example:
   `https://myaccount.blob.core.windows.net`. See
   [authentication](#authentication).
 - `secret_access_key`: specifies the
   [Azure Blob Storage account key](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-keys-manage),
   see [authentication](#authentication).
+
+Parameters for `--cache-to`:
+
 - `mode`: specify cache layers to export (default: `min`), see
   [cache mode](./index.md#cache-mode)
 
diff --git a/docs/guides/cache/inline.md b/docs/guides/cache/inline.md
index 3693b85c..9a8d92a2 100644
--- a/docs/guides/cache/inline.md
+++ b/docs/guides/cache/inline.md
@@ -8,6 +8,14 @@ and your cache output. This means that if you're using a particularly complex
 build flow, or not exporting your images directly to a registry, then you may
 want to consider the [registry](./registry.md) cache.
 
+## Synopsis
+
+```console
+$ docker buildx build . --push -t <registry>/<image> \
+  --cache-to type=inline \
+  --cache-from type=registry,ref=<registry>/image
+```
+
 To export cache using `inline` storage, pass `type=inline` to the `--cache-to`
 option:
 
@@ -30,15 +38,6 @@ the specified registry:
 $ docker buildx build . --push -t <registry>/<image> --cache-from type=registry,ref=<registry>/<image>
 ```
 
-Most of the time, you'll want to have each build both import and export cache
-from the cache store. To do this, specify both `--cache-to` and `--cache-from`:
-
-```console
-$ docker buildx build . --push -t <registry>/<image> \
-    --cache-to type=inline \
-    --cache-from type=registry,ref=<registry>/<image>
-```
-
 ## Further reading
 
 For an introduction to caching see
diff --git a/docs/guides/cache/local.md b/docs/guides/cache/local.md
index 46c6a02d..fc06fec9 100644
--- a/docs/guides/cache/local.md
+++ b/docs/guides/cache/local.md
@@ -53,6 +53,8 @@ Parameters for `--cache-from`:
 
 ## Cache versioning
 
+<!-- FIXME: update once https://github.com/moby/buildkit/pull/3111 is released -->
+
 This section describes how versioning works for caches on a local filesystem,
 and how you can use the `digest` parameter to use older versions of cache.