[MPMD-333] - Add release notes documentation
diff --git a/src/site/markdown/releasenotes.md b/src/site/markdown/releasenotes.md
new file mode 100644
index 0000000..3e0138d
--- /dev/null
+++ b/src/site/markdown/releasenotes.md
@@ -0,0 +1,233 @@
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+
+-->
+
+# Release Notes
+
+## Version 3.17.0-SNAPSHOT
+
+**Release Date:** not released yet
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.17.0](https://issues.apache.org/jira/projects/MPMD/versions/12351350)
+
+**GitHub:** <https://github.com/apache/maven-pmd-plugin/releases>
+
+## 🐛 Bug Fixes
+
+## 🚀 New features and improvements
+* [MPMD-309](https://issues.apache.org/jira/browse/MPMD-309) - Add configuration option to show suppressed violations
+* [MPMD-332](https://issues.apache.org/jira/browse/MPMD-332) - Support Java 18
+
+### 📝 Documentation updates
+* [MPMD-333](https://issues.apache.org/jira/browse/MPMD-333) - Add release notes documentation
+
+## 📦 Dependency updates
+* [MPMD-329](https://issues.apache.org/jira/browse/MPMD-329) - Upgrade to PMD 6.44.0
+* [MPMD-330](https://issues.apache.org/jira/browse/MPMD-330) - Upgrade Maven Parent to 35
+* [MPMD-331](https://issues.apache.org/jira/browse/MPMD-331) - Require Maven 3.2.5+
+
+## Version 3.16.0
+
+**Release Date:** 2022-02-05
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.16.0](https://issues.apache.org/jira/projects/MPMD/versions/12350599)
+
+**GitHub:** <https://github.com/apache/maven-pmd-plugin/releases/tag/maven-pmd-plugin-3.16.0>
+
+## 🐛 Bug Fixes
+* [MPMD-325](https://issues.apache.org/jira/browse/MPMD-325) - Could not find class due to IncompatibleClassChangeError warning
+* [MPMD-324](https://issues.apache.org/jira/browse/MPMD-324) - Ruleset URLs have hyphen replaced with forwardslash
+* [MPMD-323](https://issues.apache.org/jira/browse/MPMD-323) - ResourceManager should use project base dir instead of pom location
+
+## 🔧 Build
+* [MPMD-328](https://issues.apache.org/jira/browse/MPMD-328) - Shared GitHub Actions
+
+## 🚀 New features and improvements
+* [MPMD-327](https://issues.apache.org/jira/browse/MPMD-327) - Upgrade to PMD 6.42.0
+
+## 📦 Dependency updates
+* [MPMD-326](https://issues.apache.org/jira/browse/MPMD-326) - Set Maven 3.1.1 as minimum version
+
+## Version 3.15.0
+
+**Release Date:** 2021-09-06
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.15.0](https://issues.apache.org/jira/projects/MPMD/versions/12349432)
+
+### 🐛 Bug Fixes
+* [MPMD-314](https://issues.apache.org/jira/browse/MPMD-314) - PMD report extension not set correctly for custom report class
+* [MPMD-315](https://issues.apache.org/jira/browse/MPMD-315) - Maven PMD Plugin fails on Java 16: Unsupported targetJdk value '16'.
+* [MPMD-317](https://issues.apache.org/jira/browse/MPMD-317) - NoClassDefFoundError for provided classes
+* [MPMD-318](https://issues.apache.org/jira/browse/MPMD-318) - Incorrect aux classpath if 'includeTests' set to true
+* [MPMD-320](https://issues.apache.org/jira/browse/MPMD-320) - Error when using toolchain and spaces in repository path
+
+### 🚀 New features and improvements
+* [MPMD-283](https://issues.apache.org/jira/browse/MPMD-283) - Create a real aggregate goal
+* [MPMD-311](https://issues.apache.org/jira/browse/MPMD-311) - Improve excludeFromFailureFile docs
+* [MPMD-313](https://issues.apache.org/jira/browse/MPMD-313) - Improve <jdkToolchain> parameter description
+* [MPMD-321](https://issues.apache.org/jira/browse/MPMD-321) - Display PMD version that is being used also for pmd:pmd and pmd:cpd
+* [MPMD-322](https://issues.apache.org/jira/browse/MPMD-322) - Display when PMD/CPD is skipped
+
+### 🔧 Build
+* [MPMD-319](https://issues.apache.org/jira/browse/MPMD-319) - Add GitHub Action to confirm build PR
+
+### 📦 Dependency updates
+* [MPMD-308](https://issues.apache.org/jira/browse/MPMD-308) - Set Maven 3.1.0 as minimum version
+* [MPMD-316](https://issues.apache.org/jira/browse/MPMD-316) - Require Java 8
+* [MPMD-312](https://issues.apache.org/jira/browse/MPMD-312) - Upgrade to PMD 6.38.0
+
+## Version 3.14.0
+
+**Release Date:** 2020-10-24
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.14.0](https://issues.apache.org/jira/projects/MPMD/versions/12346940)
+
+### 🐛 Bug Fixes
+* [MPMD-297](https://issues.apache.org/jira/browse/MPMD-297) - Classloader not being closed after PMD run
+* [MPMD-300](https://issues.apache.org/jira/browse/MPMD-300) - Unable to format output with custom renderer (CodeClimateRenderer)
+* [MPMD-305](https://issues.apache.org/jira/browse/MPMD-305) - CPD goal does not support txt as a format parameter
+* [MPMD-307](https://issues.apache.org/jira/browse/MPMD-307) - NPE when using custom rule
+
+### 🚀 New features and improvements
+* [MPMD-290](https://issues.apache.org/jira/browse/MPMD-290) - Add CPD example for C#
+* [MPMD-301](https://issues.apache.org/jira/browse/MPMD-301) - make build Reproducible
+* [MPMD-304](https://issues.apache.org/jira/browse/MPMD-304) - maven-pmd-plugin should be toolchains-aware
+
+### 📦 Dependency updates
+* [MPMD-298](https://issues.apache.org/jira/browse/MPMD-298) - Upgrade Doxia Sitetools to 1.9.2 to remove dependency on Struts
+* [MPMD-302](https://issues.apache.org/jira/browse/MPMD-302) - Upgrade to PMD 6.29.0
+
+## Version 3.13.0
+
+**Release Date:** 2020-01-25
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.13.0](https://issues.apache.org/jira/projects/MPMD/versions/12345409)
+
+### 🐛 Bug Fixes
+* [MPMD-288](https://issues.apache.org/jira/browse/MPMD-288) - NullPointerException when File.list() returns null
+* [MPMD-289](https://issues.apache.org/jira/browse/MPMD-289) - check: unable to find pmd.xml
+* [MPMD-292](https://issues.apache.org/jira/browse/MPMD-292) - PMD Log is not always integrated into maven log
+* [MPMD-295](https://issues.apache.org/jira/browse/MPMD-295) - Maven PMD Plugin fails on Java 13: Unsupported targetJdk value '13'
+
+### 🚀 New features and improvements
+* [MPMD-225](https://issues.apache.org/jira/browse/MPMD-225) - Create report even if no warnings have been found by default
+* [MPMD-269](https://issues.apache.org/jira/browse/MPMD-269) - Display PMD version that is being used
+* [MPMD-296](https://issues.apache.org/jira/browse/MPMD-296) - Copy ruleset files into a subdirectory of target
+
+### 📝 Documentation updates
+* [MPMD-241](https://issues.apache.org/jira/browse/MPMD-241) - Document the version relationship between plugin and pmd
+* [MPMD-287](https://issues.apache.org/jira/browse/MPMD-287) - Add additional contribution information for GitHub
+
+### 🔧 Build
+* [MPMD-285](https://issues.apache.org/jira/browse/MPMD-285) - remove pluginTools version override for build (which block reproducible build...)
+* [MPMD-293](https://issues.apache.org/jira/browse/MPMD-293) - Fix integration test builds on jenkins
+
+### 📦 Dependency updates
+* [MPMD-291](https://issues.apache.org/jira/browse/MPMD-291) - Upgrade to PMD 6.21.0
+
+## Version 3.12.0
+
+**Release Date:** 2019-04-11
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.12.0](https://issues.apache.org/jira/projects/MPMD/versions/12344380)
+
+### 🐛 Bug Fixes
+* [MPMD-277](https://issues.apache.org/jira/browse/MPMD-277) - Plugin tries to download local submodules from repo
+
+### 🚀 New features and improvements
+* [MPMD-280](https://issues.apache.org/jira/browse/MPMD-280) - Support targetJdk 12
+* [MPMD-281](https://issues.apache.org/jira/browse/MPMD-281) - Display found violations grouped by priority
+* [MPMD-282](https://issues.apache.org/jira/browse/MPMD-282) - Add rule name to HTML report
+
+### 📝 Documentation updates
+* [MPMD-279](https://issues.apache.org/jira/browse/MPMD-279) - Improve documentation of maxAllowedViolations
+
+### 📦 Dependency updates
+* [MPMD-275](https://issues.apache.org/jira/browse/MPMD-275) - Upgrade to PMD 6.13.0
+* [MPMD-284](https://issues.apache.org/jira/browse/MPMD-284) - Upgrade parent to 33
+
+## Version 3.11.0
+
+**Release Date:** 2018-10-23
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.11.0](https://issues.apache.org/jira/projects/MPMD/versions/12343406)
+
+### 🐛 Bug Fixes
+* [MPMD-266](https://issues.apache.org/jira/browse/MPMD-266) - Aggregate report in multi-module projects doesn't use correct auxclasspath
+* [MPMD-268](https://issues.apache.org/jira/browse/MPMD-268) - Missing warnings about deprecated rules
+
+### 🚀 New features and improvements
+* [MPMD-270](https://issues.apache.org/jira/browse/MPMD-270) - JDK 11 compatibility
+* [MPMD-272](https://issues.apache.org/jira/browse/MPMD-272) - Support ignoreAnnotations options for CPD
+
+### 📦 Dependency updates
+* [MPMD-271](https://issues.apache.org/jira/browse/MPMD-271) - Upgrade pmd 6.8.0
+
+## Version 3.10.0
+
+**Release Date:** 2018-05-29
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.10.0](https://issues.apache.org/jira/projects/MPMD/versions/12342689)
+
+### 🐛 Bug Fixes
+* [MPMD-253](https://issues.apache.org/jira/browse/MPMD-253) - PMD links to java Xref fail in aggregated report
+* [MPMD-257](https://issues.apache.org/jira/browse/MPMD-257) - Allow to disable analysisCache completely, avoid warnings
+* [MPMD-258](https://issues.apache.org/jira/browse/MPMD-258) - PMD output multiplies with every module in multi module projects
+* [MPMD-259](https://issues.apache.org/jira/browse/MPMD-259) - FileNotFoundException with analysisCache=true, includeTests=true and no test classes
+
+### 🚀 New features and improvements
+* [MPMD-256](https://issues.apache.org/jira/browse/MPMD-256) - Add maxAllowedViolations property for PMD
+* [MPMD-264](https://issues.apache.org/jira/browse/MPMD-264) - Add rule priority to HTML report
+
+### 📝 Documentation updates
+* [MPMD-263](https://issues.apache.org/jira/browse/MPMD-263) - Add documentation information for GitHub
+
+### 📦 Dependency updates
+* [MPMD-252](https://issues.apache.org/jira/browse/MPMD-252) - Upgrade parent to 31
+* [MPMD-261](https://issues.apache.org/jira/browse/MPMD-261) - Upgrade to PMD 6.4.0
+* [MPMD-262](https://issues.apache.org/jira/browse/MPMD-262) - Upgrade maven-surefire/failsafe-plugin 2.21.0
+
+## Version 3.9.0
+
+**Release Date:** 2018-01-21
+
+**JIRA:** [Release Notes - Maven PMD Plugin - Version 3.9.0](https://issues.apache.org/jira/projects/MPMD/versions/12340516)
+
+### 💥 Breaking changes
+* [MPMD-240](https://issues.apache.org/jira/browse/MPMD-240) - Migrate plugin to Maven 3.0
+
+### 🐛 Bug Fixes
+* [MPMD-244](https://issues.apache.org/jira/browse/MPMD-244) - Maven PMD plugin fails but no reason is given for the failure
+* [MPMD-245](https://issues.apache.org/jira/browse/MPMD-245) - targetJdk property should use maven.compiler.source by default
+* [MPMD-248](https://issues.apache.org/jira/browse/MPMD-248) - cpd-check goal leaks file handle
+* [MPMD-249](https://issues.apache.org/jira/browse/MPMD-249) - The plugin documentation point to old (deprecated) rulesets
+* [MPMD-251](https://issues.apache.org/jira/browse/MPMD-251) - Invalid report XML is generated with includeXmlInSite=true
+
+### 🚀 New features and improvements
+* [MPMD-246](https://issues.apache.org/jira/browse/MPMD-246) - Output details of processing errors
+
+### 📝 Documentation updates
+* [MPMD-239](https://issues.apache.org/jira/browse/MPMD-239) - Add documentation about upgrading PMD version at runtime
+
+### 🔧 Build
+* [MPMD-235](https://issues.apache.org/jira/browse/MPMD-235) - Javadoc errors when building with java8
+
+### 📦 Dependency updates
+* [MPMD-247](https://issues.apache.org/jira/browse/MPMD-247) - Upgrade to PMD 6.0.1
diff --git a/src/site/site.xml b/src/site/site.xml
index 7df2790..fc6b1dd 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -31,6 +31,7 @@
<!-- According to https://issues.apache.org/jira/browse/MNGSITE-152 -->
<item name="License" href="http://www.apache.org/licenses/"/>
<item name="Download" href="download.html"/>
+ <item name="Release Notes" href="releasenotes.html"/>
</menu>
<menu name="Examples">
<item name="Upgrading PMD at Runtime" href="examples/upgrading-PMD-at-runtime.html"/>
