diff --git a/doc/metropolistheme.dtx b/doc/metropolistheme.dtx
index 785ecf2..9326d6d 100644
--- a/doc/metropolistheme.dtx
+++ b/doc/metropolistheme.dtx
@@ -363,7 +363,10 @@ The list of options is structured as shown in the following example.
 \DescribeOption{subsectionpage}{none, simple, progressbar}{none}{
   Optionally adds a slide at the start of each subsection. If enabled with
   the |simple| or |progressbar| options, the style of the |section page| will
-  be updated to match the style of the |subsection page|.
+  be updated to match the style of the |subsection page|. Note that section
+  slides and subsection slides can appear consecutively if both are enabled;
+  you may want to use this option together with |sectionpage=none| depending
+  on the section structure of your presentation.
 }