From 4b6270b981612f1108d23c3fbe0f85ed28f2ca18 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20CROCQUESEL?=
 <88554524+scrocquesel@users.noreply.github.com>
Date: Mon, 8 Nov 2021 08:30:23 +0100
Subject: [PATCH] docs: document how docker datasource resolve sourceUrl
 (#12468)

---
 lib/datasource/docker/readme.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 lib/datasource/docker/readme.md

diff --git a/lib/datasource/docker/readme.md b/lib/datasource/docker/readme.md
new file mode 100644
index 0000000000..fac24ca307
--- /dev/null
+++ b/lib/datasource/docker/readme.md
@@ -0,0 +1,5 @@
+This datasource identifies an image's source repository according to the [pre-defined annotation keys of the OCI Image Format Specification](https://github.com/opencontainers/image-spec/blob/main/annotations.md).
+
+This datasource looks for the metadata of the **latest stable** image found on the Docker registry and uses the value of the label `org.opencontainers.image.source` as the `sourceUrl`.
+
+The [Label Schema](https://label-schema.org/) is superseded by OCI annotations, therefore this datasource does not support the `org.label-schema.vcs-url` label.
-- 
GitLab