diff --git a/website/docs/3-concepts/5-compose/5-configs.md b/website/docs/3-concepts/7-configs.md
similarity index 100%
rename from website/docs/3-concepts/5-compose/5-configs.md
rename to website/docs/3-concepts/7-configs.md
diff --git a/website/docs/3-concepts/5-compose/1-support-matrix.md b/website/docs/8-compose-file-reference/1-support-matrix.md
similarity index 97%
rename from website/docs/3-concepts/5-compose/1-support-matrix.md
rename to website/docs/8-compose-file-reference/1-support-matrix.md
index 47d1c7bd..74c06dfb 100644
--- a/website/docs/3-concepts/5-compose/1-support-matrix.md
+++ b/website/docs/8-compose-file-reference/1-support-matrix.md
@@ -83,7 +83,7 @@ services:
       - 8080:80/tcp@host
 ```
 
-See [Publishing services](../1-ingress/2-publishing-services.md) for more details.
+See [Publishing services](../3-concepts/1-ingress/2-publishing-services.md) for more details.
 
 ### `x-caddy`
 
@@ -99,7 +99,7 @@ services:
       }
 ```
 
-See [Publishing services](../1-ingress/2-publishing-services.md) for more details.
+See [Publishing services](../3-concepts/1-ingress/2-publishing-services.md) for more details.
 
 ### `x-machines`
 
diff --git a/website/docs/3-concepts/5-compose/_category_.yaml b/website/docs/8-compose-file-reference/_category_.yaml
similarity index 73%
rename from website/docs/3-concepts/5-compose/_category_.yaml
rename to website/docs/8-compose-file-reference/_category_.yaml
index 210244e3..97092cc5 100644
--- a/website/docs/3-concepts/5-compose/_category_.yaml
+++ b/website/docs/8-compose-file-reference/_category_.yaml
@@ -1,4 +1,4 @@
-label: Compose features
+label: Compose file reference
 collapsed: true # keep the category closed by default
 link:
   type: generated-index