diff --git a/lib/modules/versioning/debian/readme.md b/lib/modules/versioning/debian/readme.md
new file mode 100644
index 00000000000000..c3625083913fd7
--- /dev/null
+++ b/lib/modules/versioning/debian/readme.md
@@ -0,0 +1,4 @@
+Debian versioning is used for Debian container images that are referenced by its major release version or a codename.
+
+Versions to which this scheme applies are e.g. `11` and `bullseye`.
+Container image tags such as `11-slim`, `11.4` or `11.4-slim`, `bullseye-20220822` or `bullseye-backports` are not compliant with the current implementation.