diff --git a/docs/ref/contrib/comments/example.txt b/docs/ref/contrib/comments/example.txt
index 921fe03ffae..253701b8da1 100644
--- a/docs/ref/contrib/comments/example.txt
+++ b/docs/ref/contrib/comments/example.txt
@@ -103,13 +103,16 @@ But let's look at a simple example::
Flagging
diff --git a/docs/ref/contrib/comments/index.txt b/docs/ref/contrib/comments/index.txt
index 817871e9765..7072ed14ac9 100644
--- a/docs/ref/contrib/comments/index.txt
+++ b/docs/ref/contrib/comments/index.txt
@@ -218,13 +218,18 @@ you can use in the template::
A complete form might look like::
{% get_comment_form for event as form %}
-
+
Be sure to read the `notes on the comment form`_, below, for some special
considerations you'll need to make if you're using this approach.