diff --git a/lib/modules/manager/dockerfile/readme.md b/lib/modules/manager/dockerfile/readme.md
index c9f1ba919a5fb93b5513d543d2bd3349b5181373..8e0a82be56336eb497028d9f0dc37d851fa87f5c 100644
--- a/lib/modules/manager/dockerfile/readme.md
+++ b/lib/modules/manager/dockerfile/readme.md
@@ -1,4 +1,52 @@
-Extracts image references in a `Dockerfile` and/or `Containerfile`.
+### Supported dependencies
+
+This manager extracts image references in a `Dockerfile` and/or `Containerfile` and supports:
+
+- [`FROM`](https://docs.docker.com/reference/dockerfile/#from) images
+- [`COPY --from`](https://docs.docker.com/reference/dockerfile/#copy---from) images
+- [`syntax`](https://docs.docker.com/reference/dockerfile/#syntax) images
+
+#### `FROM` support
+
+Renovate can update images referenced in `FROM` directives.
+This even works for multi-stage builds with many `FROM` directives in one Dockerfile.
+
+```dockerfile
+FROM node:20.9.0
+```
+
+Advanced `FROM` flags like `--platform` or `AS <name>` are also supported:
+
+```dockerfile
+FROM --platform=linux/amd64 node:20.9.0 AS installer
+```
+
+Also, Renovate will automatically expand variables and [`ARG` directives](https://docs.docker.com/reference/dockerfile/#understand-how-arg-and-from-interact):
+
+```dockerfile
+ARG TAG=3.19.4
+FROM alpine:${TAG}
+```
+
+#### `COPY --from` support
+
+Renovate can update images referenced in `COPY --from` directives.
+
+```dockerfile
+FROM node:20.9.0
+COPY --from alpine:3.19.4 /bin/sh /usr/local/sh
+```
+
+#### `syntax` support
+
+Renovate can update `syntax` references.
+
+```dockerfile
+# syntax=docker/dockerfile:1.9.0
+FROM alpine:3.19.4
+```
+
+### Versioning
 
 Renovate's managers does not understand versioning, that's up to Renovate's versioning modules.
 The default `docker` versioning for container image datasources treats suffixes as "compatibility", for example: `-alpine`.
diff --git a/lib/modules/manager/flux/readme.md b/lib/modules/manager/flux/readme.md
index f13c99c7ebf4af7b204379a2b9d84e191e476f54..bb1777f3bd8f05a49843a34f8a8b2766e481bcf0 100644
--- a/lib/modules/manager/flux/readme.md
+++ b/lib/modules/manager/flux/readme.md
@@ -1,8 +1,8 @@
 This manager parses [Flux](https://fluxcd.io/) YAML manifests and supports:
 
 1. [`HelmRelease`](https://fluxcd.io/docs/components/helm/helmreleases/) resources
-1. ['GitRepository'](https://fluxcd.io/flux/components/source/gitrepositories/) resources
-1. ['OCIRepository'](https://fluxcd.io/flux/components/source/ocirepositories/) resources
+1. [`GitRepository`](https://fluxcd.io/flux/components/source/gitrepositories/) resources
+1. [`OCIRepository`](https://fluxcd.io/flux/components/source/ocirepositories/) resources
 1. Flux [system](https://fluxcd.io/docs/installation) manifests
 
 ### HelmRelease support