diff --git a/docs/_includes/custom/shuffle_panel.html b/docs/_includes/custom/shuffle_panel.html
index 4930533579..ffe3b4adb0 100644
--- a/docs/_includes/custom/shuffle_panel.html
+++ b/docs/_includes/custom/shuffle_panel.html
@@ -46,7 +46,7 @@
                     {% capture excluded %}{{ page.tags | intersect: exclude_tags | empty }}{% endcapture %}
 
                     {% if included contains "true" and excluded contains "true" %}
-                        <li><a href="{{page.url | remove: '/'}}">{{ titlemaker }}</a></li>
+                        <li><a href="{{page.url | remove: '/'}}">{% eval titlemaker %}</a></li>
                     {% endif %}
                 {% endfor %}
             </ul>
diff --git a/docs/index.md b/docs/index.md
index 4ffd865fc1..55e9c9e5cd 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -38,8 +38,8 @@ also support an extensive API to [**write your own rules**](#shuffle-panel-writi
 which you can do either in Java or as a self-contained XPath query.
 
 PMD is most useful when **integrated into your build process**. It can then be
-used as a quality gate, to enforce a coding standard for your codebase. PMD
-can be used:
+used as a quality gate, to enforce a coding standard for your codebase. Among other
+things, PMD can be run:
 * As a [Maven goal](pmd_userdocs_tools_maven.html)
 * As an [Ant task](pmd_userdocs_tools_ant.html)
 * As a [Gradle task](https://docs.gradle.org/current/userguide/pmd_plugin.html)