diff --git a/doc/examples/blog.mdwn b/doc/examples/blog.mdwn
index 3e89c4b99..afdabe316 100644
--- a/doc/examples/blog.mdwn
+++ b/doc/examples/blog.mdwn
@@ -12,7 +12,12 @@ Some additional configuration you might want to do:
   example of how to tag a post is:
 	\[[!tag tags/life]]
 
-* Enable the sidebar plugin to get a sidebar listing all the categories
-  you've tagged posts with.
+* Enable the [[sidebar|plugin/sidebar]] plugin to get a sidebar listing all
+  the categories you've tagged posts with.
 
-* Enable the pagestats plugin to get a tag cloud display on the [[index]].
+* Enable the [[pagestats|plugin/pagestats]] plugin to get a tag cloud
+* display on the [[index]].
+
+* Enable the [[comments|plugin/comments]] plugin and configure it to
+  enable comments to posts to the blog:
+  	comments_pagespec => 'blog/posts/*',