Describe possibility of page collisions with content adapters

gohugoio · May 16, 2024 · 9771010 · 9771010
1 parent d57b8a8
commit 9771010
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/content/en/content-management/content-adapters.md b/content/en/content-management/content-adapters.md
@@ -330,6 +330,20 @@ content/
         └── _index.md
 ```
 
+## Page collisions
+
+Two or more pages collide when they have the same publication path. Due to concurrency, the content of the published page is indeterminate. Consider this example:
+
+```text
+content/
+└── books/
+    ├── _content.gotmpl  <-- content adapter
+    ├── _index.md
+    └── the-hunchback-of-notre-dame.md
+```
+
+If the content adapter also creates books/the-hunchback-of-notre-dame, the content of the published page is indeterminate. You can not define the rendering order. Avoid this content structure.
+
 [content formats]: /content-management/formats/#classification
 [front matter field]: /content-management/front-matter/#fields
 [logical path]: /getting-started/glossary/#logical-path