summaryrefslogtreecommitdiff
path: root/frags/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'frags/README.md')
-rw-r--r--frags/README.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/frags/README.md b/frags/README.md
index 9facc4c0..0fe7923f 100644
--- a/frags/README.md
+++ b/frags/README.md
@@ -4,7 +4,9 @@ This directory contains fragments to be included by the directive:
.. include:: RELATIVE-FILE-NAME
-If the fragment includes headers, you MUST include it at top-level.
-Otherwise, you MUST include it only at "block" level.
+If the fragment includes header lines, you MUST include it at top-level
+(no indentation for the directive).
+
+Otherwise, it can be included at either top-level or indented.
See <https://docutils.sourceforge.io/docs/ref/rst/directives.html#including-an-external-document-fragment>.