Merge pull request #672 from lsst-dm/u/jonathansick/describe-toctrees

Describe the essential nature of listing pages in toctrees.
lsst-dm · Apr 29, 2024 · 5583728 · 5583728
2 parents 9e33948 + e64afa2
commit 5583728
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/stack/module-homepage-topic-type.rst b/stack/module-homepage-topic-type.rst
@@ -99,6 +99,9 @@ In most cases, you can add a single section titled “Using <module>” containi
       howto-a
       howto-b
 
+Besides providing navigation from the module page, these toctree_ directives also define the hierarchical structure of pages in the documentation.
+All pages need to be listed through a toctree_.
+
 .. _module-homepage-python-contributing:
 
 Contributing section