Use jekyll tags properly, create apex page placeholder

docs/_data/sidebars/pmd_sidebar.yml

@@ -349,13 +349,16 @@ entries:
         - title: Performance
           output: web, pdf
           url: /pmd_rules_xsl_performance.html
-  - title: Language Specific Documentation
+  - title: Language-Specific Documentation
     output: web, pdf
     folderitems:
-    - title: Java Support
+    - title: Apex
+      url: /pmd_languages_apex.html
+      output: web, pdf
+    - title: Java
       url: /pmd_languages_java.html
       output: web, pdf
-    - title: JSP Support
+    - title: JSP
       url: /pmd_languages_jsp.html
       output: web, pdf
     - title: PLSQL

docs/_data/tags.yml

@@ -9,4 +9,4 @@ allowed-tags:
   - metrics         # About using metrics, and metrics indices
   - tools           # About tools and integrations, Maven, gradle, etc.
   - devdocs         # About PMD internals, contributing, building, projects
-  - languages
+  - languages       # Language-specific documentation pages

docs/pages/pmd/languages/apex.md

@@ -0,0 +1,10 @@
+---
+title: Apex support
+permalink: pmd_languages_apex.html
+author: Clément Fournier
+last_updated: March 2021 (7.0.0)
+tags: [languages]
+summary: "Apex-specific features and guidance"
+---
+
+{% include warning.html content="Todo for pmd 7" %}

docs/pages/pmd/languages/java.md

@@ -2,6 +2,9 @@
 title: Java support
 permalink: pmd_languages_java.html
 author: Clément Fournier
+last_updated: March 2021 (7.0.0)
+tags: [languages]
+summary: "Java-specific features and guidance"
 ---
 
 {% include warning.html content="WIP, todo for pmd 7" %}

docs/pages/pmd/languages/jsp.md

@@ -2,6 +2,8 @@
 title: JSP Support
 permalink: pmd_languages_jsp.html
 author: Pieter Vanraemdonck
+tags: [languages]
+summary: "JSP-specific features and guidance"
 ---
 
 ## What is currently supported and what is not

docs/pages/pmd/languages/plsql.md

@@ -1,7 +1,9 @@
 ---
-title: PLSQL
+title: PLSQL Support
 permalink: pmd_languages_plsql.html
 last_updated: March 2021 (6.33.0)
+tags: [languages]
+summary: "PLSQL-specific features and guidance"
 ---
 
 ## Parsing Exclusions

docs/pages/pmd/userdocs/extending/writing_java_rules.md

@@ -27,6 +27,7 @@ your rule as you add test cases.
 In this page we'll talk about rules for the Java language, but the process is
 very similar for other languages.
 
+{% include note.html content="[Please find an index of language-specific documentation here](tag_languages.html)" %}
 
 ## Basics
 
@@ -133,8 +134,6 @@ The start method is called exactly once per file.
 
 <!-- We don't support language-independent rules anyway... -->
 
-
-
 ## Rule lifecycle reference
 
 ### Construction

docs/pages/tags/tag_languages.md

@@ -1,5 +1,5 @@
 ---
-title: "Supported Lanugages"
+title: "Supported Languages"
 tagName: languages
 search: exclude
 permalink: tag_languages.html