diff --git a/doc/plugins/shortcut.mdwn b/doc/plugins/shortcut.mdwn
index 16dfdb44a..8a31a9bd1 100644
--- a/doc/plugins/shortcut.mdwn
+++ b/doc/plugins/shortcut.mdwn
@@ -2,11 +2,7 @@
 [[tag type/format]]
 
 This plugin allows external links to commonly linked to sites to be made
-more easily using shortcuts. Some examples of using shortcuts include:
-
-	\[[google foo]]
-	\[[wikipedia War_of_1812]]
-	\[[debbug 12345]]
+more easily using shortcuts.
 
 The available shortcuts are defined on the [[shortcuts]] page in
 the wiki.
diff --git a/doc/shortcuts.mdwn b/doc/shortcuts.mdwn
index ab3fb1031..469f5a23c 100644
--- a/doc/shortcuts.mdwn
+++ b/doc/shortcuts.mdwn
@@ -2,6 +2,12 @@
      then="This wiki has shortcuts **enabled**."
      else="This wiki has shortcuts **disabled**."]]
 
+Some examples of using shortcuts include:
+
+	\[[google foo]]
+	\[[wikipedia War_of_1812]]
+	\[[debbug 12345]]
+
 This page controls what shortcut links the wiki supports.
 
 * [[shortcut name=google url="http://www.google.com/search?q=%s"]]