diff --git a/doc/guide/admin/slapdconfig.sdf b/doc/guide/admin/slapdconfig.sdf
index 030d6702ba..239c7eb12e 100644
--- a/doc/guide/admin/slapdconfig.sdf
+++ b/doc/guide/admin/slapdconfig.sdf
@@ -28,8 +28,10 @@ can be overridden by database directives.
 
 Blank lines and comment lines beginning with a '{{EX:#}}' character
 are ignored.  If a line begins with white space, it is considered a
-continuation of the previous line. The general format of slapd.conf is
-as follows:
+continuation of the previous line (even if the previous line is a
+comment).
+
+The general format of slapd.conf is as follows:
 
 >	# global configuration directives
 >	<global config directives>
diff --git a/doc/guide/admin/syncrepl.sdf b/doc/guide/admin/syncrepl.sdf
index 0c55cc73f5..81785f1bad 100644
--- a/doc/guide/admin/syncrepl.sdf
+++ b/doc/guide/admin/syncrepl.sdf
@@ -7,7 +7,7 @@ H1: LDAP Sync Replication
 The LDAP Sync replication engine is designed to function as an
 improved alternative to {{slurpd}}(8).  While the replication with
 {{slurpd}}(8) provides the replication capability for improved capacity,
-availability, and reliability, it has some drawbacks :
+availability, and reliability, it has some drawbacks:
 
 ^ It is not stateful, hence lacks the resynchronization capability.
 Because there is no representation of replica state in the replication