From f553b688a556d2eed56964d52b0d12297aea64f9 Mon Sep 17 00:00:00 2001
From: Jordy Schreuders <3071062+99linesofcode@users.noreply.github.com>
Date: Sat, 10 Oct 2026 15:17:42 +0200
Subject: [PATCH] docs: describe the three-tier docker environment model

---
 README.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5a957ff..343b212 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,11 @@
 # docker-collection
 
-This repository serves as a reference for my collection of Docker and Docker Compose files.
+This repository serves as a reference for my collection of Docker and Docker
+Compose files. The environments are three tiers:
+
+- **[docker-base](https://github.com/99linesofcode/docker-base)** — the shared services and the Ubuntu-LTS devcontainer. A wrapper pulls it in as the `base` submodule.
+- **Language wrappers** (`docker-php`, `docker-ruby`) — extend the base and add language-specific services. A project pulls a wrapper in as the `docker` submodule.
+- **Projects** — copy the wrapper's `docker-compose.yaml.dist` to their root as `docker-compose.yaml`.
 
 ## Configuration