From b40fff396d612a263aea836940857305a886164e Mon Sep 17 00:00:00 2001
From: Ingo Struck <github@ingostruck.de>
Date: Mon, 6 Nov 2023 17:06:31 +0100
Subject: [PATCH] Add showcase for hidden sections without index.html

---
 .../en/content-management/build-options.md    | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/content/en/content-management/build-options.md b/content/en/content-management/build-options.md
index 9df98b2b1..2fddcedd7 100644
--- a/content/en/content-management/build-options.md
+++ b/content/en/content-management/build-options.md
@@ -100,3 +100,24 @@ cascade:
   {{ end }}
 </section>
 {{< /code >}}
+
+#### Not rendering an index file for a hidden section
+
+Website wants to hide a section from sitemap, menu and other navigation, but still wants to have all children rendered.
+
+See the forum question: [Disable generating empty index.html pages created for sections](https://discourse.gohugo.io/t/disable-generating-empty-index-html-pages-created-for-sections/11036/1)
+
+This use case leverages [`cascade`](/content-management/front-matter#front-matter-cascade) as well.
+
+{{< code-toggle >}}
+title: Section without index file
+url: /hidden-section/
+_build:
+  render: never
+  list: never
+  publishResources: false
+cascade:
+  _build:
+    list: false
+    render: true
+{{< /code-toggle >}}