diff --git a/template/module/readme/DESCRIPTION.rst b/template/module/readme/DESCRIPTION.rst
index fc84a0ab..3583b175 100644
--- a/template/module/readme/DESCRIPTION.rst
+++ b/template/module/readme/DESCRIPTION.rst
@@ -3,3 +3,6 @@
 This module extends the functionality of ... to support ...
 and to allow you to ...
 
+Fragments may contain section titles. The first title level must be underlined
+with the ``~`` (tilde) character. Subsections can be underlined using any
+non-alphanumeric character, other than ``~``, ``=`` and ``-``.