diff --git a/doc/modsecurity2-apache-reference.xml b/doc/modsecurity2-apache-reference.xml
index 068292dc..2c242802 100644
--- a/doc/modsecurity2-apache-reference.xml
+++ b/doc/modsecurity2-apache-reference.xml
@@ -1298,8 +1298,9 @@ SecAuditLogStorageDir logs/audit
       <title><literal>SecMarker</literal></title>
 
       <para><emphasis>Description:</emphasis> Adds a fixed rule marker in the
-      ruleset to be used as a target in a <emphasis>skipAfter</emphasis>
-      action.</para>
+      ruleset to be used as a target in a <literal>skipAfter</literal> action.
+      A <literal>SecMarker</literal> directive essentially creates a rule that
+      does nothing and whose only purpose it to carry the given ID.</para>
 
       <para><emphasis>Syntax:</emphasis> <literal moreinfo="none">SecMarker
       ID</literal></para>
@@ -5205,7 +5206,7 @@ SecRule &amp;REQUEST_HEADERS:Accept "@eq 0" \
       <title><literal>skipAfter</literal></title>
 
       <para><emphasis>Description:</emphasis> Skips rules (or chains) on
-      successful match resuming rule execution after the specified rule id or
+      successful match resuming rule execution after the specified rule ID or
       marker (see <literal>SecMarker</literal>) is found.</para>
 
       <para><emphasis>Action Group:</emphasis> Flow</para>