diff --git a/compose/compose-file/index.md b/compose/compose-file/index.md index 26483fe9f4..0c785c3b33 100644 --- a/compose/compose-file/index.md +++ b/compose/compose-file/index.md @@ -16,6 +16,21 @@ For a Compose/Docker Engine compatibility matrix, and detailed guidelines on versions and upgrading, see [Compose file versions and upgrading](compose-versioning.md). +## Compose file structure and examples + +The topics on this reference page are organized alphabetically by top-level key +to reflect the structure of the Compose file itself. Top-level keys that define +a section in the configuration file such as `build`, `deploy`, `depends_on`, +`networks`, and so on, are listed with the options that support them as +sub-topics. This maps to the `: