Prepare release of pmd-compat6 7.0.0-rc4

Add pmd-compat6 module for maven-pmd-plugin #4741

.ci/README.md

@@ -138,7 +138,7 @@ f=check-environment.sh; \
 
 Calling `.ci/build.sh` directly would re-release the tag $TAG_NAME - that's why it is commented out.
 All the side-effects of a release would be carried out like creating and publishing a release on github,
-uploading the release to sourceforge, uploading the docs to pmd.github.io/docs.pmd-code.org, uploading a
+uploading the release to sourceforge, uploading the docs to docs.pmd-code.org, uploading a
 new baseline for the regression tester and so on. While the release should be reproducible and therefore should
 produce exactly the same artifacts, re-uploading artifacts is not desired just for testing.
 

.ci/files/all-regression-rules.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 
 <ruleset name="All Regression Rules" 
     xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"

.ci/files/project-list.xml

@@ -134,6 +134,25 @@ index 6021fa574d..15d29ed699 100644
 EOF
 ) | patch --strip=1
 
+# Patch 4: Add https://maven.repository.redhat.com/ga/ as repository in order to resolve
+#   dependency com.ibm.websphere/uow/6.0.2.17
+#   See https://spring.io/blog/2020/10/29/notice-of-permissions-changes-to-repo-spring-io-fall-and-winter-2020
+(cat <<EOF
+diff --git a/build.gradle b/build.gradle
+index 6021fa57..8319ff76 100644
+--- a/build.gradle
++++ b/build.gradle
+@@ -291,6 +291,7 @@ configure(allprojects) { project ->
+ 		}
+ 		repositories {
+ 			mavenCentral()
++			maven { url "https://maven.repository.redhat.com/ga/" }
+ 			maven { url "https://repo.spring.io/libs-spring-framework-build" }
+ 		}
+ 	}
+EOF
+) | patch --strip=1
+
 ./gradlew --console=plain --build-cache --no-daemon --max-workers=4 build testClasses -x test -x javadoc -x api -x asciidoctor -x asciidoctorPdf
 ./gradlew --console=plain --build-cache --no-daemon --max-workers=4 createSquishClasspath -q > classpath.txt
 ]]></build-command>
@@ -169,4 +188,12 @@ EOF
     <tag>v2.3.0</tag>
     <src-subpath>samples</src-subpath>
   </project>
+
+  <project>
+    <name>java-regression-tests</name>
+    <type>git</type>
+    <connection>https://github.com/pmd/java-regression-tests</connection>
+    <tag>main</tag>
+    <auxclasspath-command>realpath java-regression-tests-*.jar</auxclasspath-command>
+  </project>
 </projectlist>

.ci/inc/pmd-code-api.inc

@@ -18,6 +18,7 @@ function pmd_code_uploadDocumentation() {
     scp "${filename}" ${PMD_CODE_SSH_USER}@pmd-code.org:${PMD_CODE_DOCS_PATH}
     # shellcheck disable=SC2029
     ssh ${PMD_CODE_SSH_USER}@pmd-code.org "cd \"${PMD_CODE_DOCS_PATH}\" && \
+            ( test -h pmd-doc-${pmdVersion} && rm pmd-doc-${pmdVersion} || true ) && \
             unzip -qo \"${basefilename}\" && \
             rm \"${basefilename}\""
     pmd_ci_log_info "Docs updated: https://docs.pmd-code.org/pmd-doc-${pmdVersion}/"

.ci/inc/pmd-doc.inc

@@ -35,62 +35,14 @@ function pmd_doc_create_archive() {
     echo -e "\n\n"
     pmd_ci_log_info "Creating pmd-doc archive..."
     mv _site "pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}"
-    zip -qr "pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}.zip" "pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}/"
-    pmd_ci_log_success "Successfully created pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}.zip"
+    zip -qr "pmd-dist-${PMD_CI_MAVEN_PROJECT_VERSION}-doc.zip" "pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}/"
+    pmd_ci_log_success "Successfully created pmd-dist-${PMD_CI_MAVEN_PROJECT_VERSION}-doc.zip"
 
     popd || exit 1
 }
 
 #
-# Publishes the site to https://pmd.github.io/pmd-${PMD_CI_MAVEN_PROJECT_VERSION} and
-# https://pmd.github.io/latest/
-#
-function publish_release_documentation_github() {
-    echo -e "\n\n"
-    pmd_ci_log_info "Adding the new doc to pmd.github.io..."
-    # clone pmd.github.io. Note: This uses the ssh key setup earlier
-    # In order to speed things up, we use a sparse checkout - no need to checkout all directories here
-    mkdir pmd.github.io
-    (
-        cd pmd.github.io || { echo "Directory 'pmd.github.io' doesn't exist"; exit 1; }
-        git init
-        git config user.name "PMD CI (pmd-bot)"
-        git config user.email "pmd-bot@users.noreply.github.com"
-        git config core.sparsecheckout true
-        git remote add origin git@github.com-pmd.github.io:pmd/pmd.github.io.git
-        echo "/latest/" > .git/info/sparse-checkout
-        echo "/sitemap.xml" >> .git/info/sparse-checkout
-        git pull --depth=1 origin master
-        pmd_ci_log_info "Copying documentation from ../docs/pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}/ to pmd-${PMD_CI_MAVEN_PROJECT_VERSION}/ ..."
-        rsync -ah --stats "../docs/pmd-doc-${PMD_CI_MAVEN_PROJECT_VERSION}/" "pmd-${PMD_CI_MAVEN_PROJECT_VERSION}/"
-        git status
-        pmd_ci_log_debug "Executing: git add pmd-${PMD_CI_MAVEN_PROJECT_VERSION}"
-        git add --sparse "pmd-${PMD_CI_MAVEN_PROJECT_VERSION}"
-        pmd_ci_log_debug "Executing: git commit..."
-        git commit -q -m "Added pmd-${PMD_CI_MAVEN_PROJECT_VERSION}"
-
-        pmd_ci_log_info "Copying pmd-${PMD_CI_MAVEN_PROJECT_VERSION} to latest ..."
-        git rm -qr latest
-        cp -a "pmd-${PMD_CI_MAVEN_PROJECT_VERSION}" latest
-        pmd_ci_log_debug "Executing: git add latest"
-        git add latest
-        pmd_ci_log_debug "Executing: git commit..."
-        git commit -q -m "Copying pmd-${PMD_CI_MAVEN_PROJECT_VERSION} to latest"
-
-        pmd_ci_log_info "Generating sitemap.xml"
-        ../docs/sitemap_generator.sh > sitemap.xml
-        pmd_ci_log_debug "Executing: git add sitemap.xml"
-        git add sitemap.xml
-        pmd_ci_log_debug "Executing: git commit..."
-        git commit -q -m "Generated sitemap.xml"
-
-        pmd_ci_log_info "Executing: git push origin master"
-        git push origin master
-    )
-}
-
-#
-# Updates github pages of the main repository,
+# Updates github pages branch "gh-pages" of the main repository,
 # so that https://pmd.github.io/pmd/ has the latest (snapshot) content
 #
 function pmd_doc_publish_to_github_pages() {

.ci/inc/regression-tester.inc

@@ -50,6 +50,7 @@ function regression_tester_uploadBaseline() {
         --patch-branch "${baseline_branch}" \
         --patch-config ./pmd/.ci/files/all-regression-rules.xml \
         --list-of-project ./pmd/.ci/files/project-list.xml --html-flag \
+        --threads "$(nproc)" \
         --error-recovery
     pushd target/reports || { echo "Directory 'target/reports' doesn't exist"; exit 1; }
     BRANCH_FILENAME="${baseline_branch/\//_}"

.github/ISSUE_TEMPLATE/0rule_violation_false-positive.md

@@ -13,13 +13,13 @@ assignees: ''
 **Rule:**
 
 Please provide the rule name and a link to the rule documentation:
-<https://pmd.github.io/latest/pmd_rules_XXX_XXX.html#XXX>
+<https://docs.pmd-code.org/latest/pmd_rules_XXX_XXX.html#XXX>
 
 **Description:**
 
 **Code Sample demonstrating the issue:**
 
-```
+```java
 
 ```
 

.github/ISSUE_TEMPLATE/1rule_violation_false-negative.md

@@ -13,13 +13,13 @@ assignees: ''
 **Rule:**
 
 Please provide the rule name and a link to the rule documentation:
-<https://pmd.github.io/latest/pmd_rules_XXX_XXX.html#XXX>
+<https://docs.pmd-code.org/latest/pmd_rules_XXX_XXX.html#XXX>
 
 **Description:**
 
 **Code Sample demonstrating the issue:**
 
-```
+```java
 
 ```
 

.github/ISSUE_TEMPLATE/2new_rule.md

@@ -17,7 +17,7 @@ assignees: ''
 **Code Sample:** This should include code, that should be flagged by the rule. If possible, the "correct" code
 according to this new rule should also be demonstrated.
 
-```
+```java
 
 ```
 

.github/ISSUE_TEMPLATE/4bug_report.md

@@ -25,7 +25,7 @@ A clear and concise description of what the bug is.
 
 **Code Sample demonstrating the issue:**
 
-```
+```java
 
 ```
 

.github/workflows/build.yml

@@ -9,21 +9,30 @@ on:
     tags:
       - '**'
   pull_request:
+  merge_group:
   schedule:
     # build it monthly: At 04:00 on day-of-month 1.
     - cron:  '0 4 1 * *'
   workflow_dispatch:
 
+permissions:
+  contents: read # to fetch code (actions/checkout)
+
 jobs:
   build:
     runs-on: ${{ matrix.os }}
+    permissions:
+      # read to fetch code (actions/checkout)
+      # write to push code to gh-pages, create releases
+      # note: forked repositories will have maximum read access
+      contents: write
     continue-on-error: false
     strategy:
       matrix:
         os: [ ubuntu-latest, windows-latest, macos-latest ]
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 2
     - uses: actions/cache@v3
@@ -45,8 +54,8 @@ jobs:
       shell: bash
       run: |
         echo "LANG=en_US.UTF-8" >> $GITHUB_ENV
-        echo "MAVEN_OPTS=-Dmaven.wagon.httpconnectionManager.ttlSeconds=180 -Dmaven.wagon.http.retryHandler.count=3 -DautoReleaseAfterClose=true -DstagingProgressTimeoutMinutes=30" >> $GITHUB_ENV
-        echo "PMD_CI_SCRIPTS_URL=https://raw.githubusercontent.com/pmd/build-tools/18/scripts" >> $GITHUB_ENV
+        echo "MAVEN_OPTS=-Daether.connector.http.connectionMaxTtl=180 -DautoReleaseAfterClose=true -DstagingProgressTimeoutMinutes=30" >> $GITHUB_ENV
+        echo "PMD_CI_SCRIPTS_URL=https://raw.githubusercontent.com/pmd/build-tools/22/scripts" >> $GITHUB_ENV
     - name: Check Environment
       shell: bash
       run: |
@@ -61,3 +70,12 @@ jobs:
       env:
         PMD_CI_SECRET_PASSPHRASE: ${{ secrets.PMD_CI_SECRET_PASSPHRASE }}
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    - name: Workaround actions/upload-artifact#176
+      run: |
+        echo "artifacts_path=$(realpath ..)" >> $GITHUB_ENV
+    - name: Upload regression tester report
+      uses: actions/upload-artifact@v3
+      with:
+        name: pmd-regression-tester
+        path: ${{ env.artifacts_path }}/target/pr-*-diff-report-*.tar.gz
+        if-no-files-found: ignore

.github/workflows/git-repo-sync.yml

@@ -9,19 +9,22 @@ on:
       - '**'
   workflow_dispatch:
 
+permissions:
+  contents: read # to fetch code (actions/checkout)
+
 jobs:
   build:
     runs-on: ubuntu-latest
     continue-on-error: false
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 100
     - name: Setup Environment
       shell: bash
       run: |
         echo "LANG=en_US.UTF-8" >> $GITHUB_ENV
-        echo "PMD_CI_SCRIPTS_URL=https://raw.githubusercontent.com/pmd/build-tools/18/scripts" >> $GITHUB_ENV
+        echo "PMD_CI_SCRIPTS_URL=https://raw.githubusercontent.com/pmd/build-tools/22/scripts" >> $GITHUB_ENV
     - name: Sync
       run: .ci/git-repo-sync.sh
       shell: bash

.github/workflows/troubleshooting.yml

@@ -15,7 +15,7 @@ jobs:
         os: [ ubuntu-latest ]
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: actions/cache@v3
         with:
           path: |
@@ -35,8 +35,8 @@ jobs:
         shell: bash
         run: |
           echo "LANG=en_US.UTF-8" >> $GITHUB_ENV
-          echo "MAVEN_OPTS=-Dmaven.wagon.httpconnectionManager.ttlSeconds=180 -Dmaven.wagon.http.retryHandler.count=3 -DstagingProgressTimeoutMinutes=30" >> $GITHUB_ENV
-          echo "PMD_CI_SCRIPTS_URL=https://raw.githubusercontent.com/pmd/build-tools/18/scripts" >> $GITHUB_ENV
+          echo "MAVEN_OPTS=-Daether.connector.http.connectionMaxTtl=180 -DstagingProgressTimeoutMinutes=30" >> $GITHUB_ENV
+          echo "PMD_CI_SCRIPTS_URL=https://raw.githubusercontent.com/pmd/build-tools/22/scripts" >> $GITHUB_ENV
       - name: Check Environment
         shell: bash
         run: |

.gitignore

@@ -21,3 +21,4 @@ node_modules
 
 # rule docs are generated
 docs/pages/pmd/rules
+.history/*

.mvn/wrapper/maven-wrapper.properties

@@ -14,5 +14,5 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.6/apache-maven-3.8.6-bin.zip
-wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.1/maven-wrapper-3.1.1.jar
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.4/apache-maven-3.9.4-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.1.0/maven-wrapper-3.1.0.jar

CONTRIBUTING.md

@@ -33,11 +33,11 @@ When filing a bug report, please provide as much information as possible, so tha
 
 ## Documentation
 
-There is some documentation available under <https://pmd.github.io/latest>. Feel free to create a bug report if
+There is some documentation available under <https://docs.pmd-code.org/latest>. Feel free to create a bug report if
 documentation is missing, incomplete or outdated. See [Bug reports](#bug-reports).
 
 The documentation is generated as a Jekyll site, the source is available at: <https://github.com/pmd/pmd/tree/master/docs>. You can find build instructions there.
-For more on contributing documentation check <https://pmd.github.io/pmd/pmd_devdocs_writing_documentation.html>
+For more on contributing documentation check <https://docs.pmd-code.org/latest/pmd_devdocs_writing_documentation.html>
 
 ## Questions
 
@@ -47,7 +47,7 @@ There are various channels, on which you can ask questions:
 
 *   Create a new discussion for your question at <https://github.com/pmd/pmd/discussions>.
 
-*   Ask your question on Gitter <https://gitter.im/pmd/pmd>.
+*   Ask your question in our [Gitter room](https://app.gitter.im/#/room/#pmd_pmd:gitter.im).
 
 ## Code Style
 

Dangerfile

@@ -2,6 +2,7 @@ require 'pmdtester'
 require 'time'
 require 'logger'
 require 'fileutils'
+require 'etc'
 
 @logger = Logger.new(STDOUT)
 
@@ -16,6 +17,7 @@ def get_args(base_branch, autogen = TRUE, patch_config = './pmd/.ci/files/all-re
    '--keep-reports',
    '--error-recovery',
    '--baseline-download-url', 'https://pmd-code.org/pmd-regression-tester/',
+   '--threads', Etc.nprocessors.to_s,
    # '--debug',
    ]
 end
@@ -49,18 +51,16 @@ def run_pmdtester
         message2 = create_message
       end
 
-      report_url = upload_report
+      tar_report
 
-      if report_url
-        message1 += "[Full report](#{report_url}/diff1/index.html)"
+      message1 += "[Download full report as build artifact](#{ENV['PMD_CI_JOB_URL']})"
+      # set value of sticky to true and the message is kept after new commits are submitted to the PR
+      message(message1, sticky: true)
+
+      if message2
+        message2 += "[Download full report as build artifact](#{ENV['PMD_CI_JOB_URL']})"
         # set value of sticky to true and the message is kept after new commits are submitted to the PR
-        message(message1, sticky: true)
-
-        if message2
-          message2 += "[Full report](#{report_url}/diff2/index.html)"
-          # set value of sticky to true and the message is kept after new commits are submitted to the PR
-          message(message2, sticky: true)
-        end
+        message(message2, sticky: true)
       end
 
     rescue StandardError => e
@@ -82,23 +82,13 @@ def create_message
   "#{@summary[:configerrors][:removed]} configuration errors.\n"
 end
 
-def upload_report
+def tar_report
   Dir.chdir('target') do
     tar_filename = "pr-#{ENV['PMD_CI_PULL_REQUEST_NUMBER']}-diff-report-#{Time.now.strftime("%Y-%m-%dT%H-%M-%SZ")}.tar.gz"
 
     `tar czf #{tar_filename} diff1/ diff2/`
     tar_size = (10 * File.size(tar_filename) / 1024 / 1024)/10.0
-    @logger.info "Uploading file #{tar_filename} (#{tar_size}mb) now..."
-    report_url = `curl -u #{ENV['PMD_CI_CHUNK_TOKEN']} -T #{tar_filename} https://chunk.io`
-    if $?.success?
-      report_url.chomp!
-      @logger.info "Successfully uploaded #{tar_filename} to #{report_url}"
-      report_url
-    else
-      @logger.error "Error while uploading #{tar_filename} to chunk.io: #{report_url}"
-      warn("Uploading the diff report failed, this message is mainly used to remind the maintainers of PMD.")
-      nil
-    end
+    @logger.info "Created file #{tar_filename} (#{tar_size}mb)"
   end
 end
 

Gemfile.lock

@@ -1,106 +1,89 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
+    addressable (2.8.5)
+      public_suffix (>= 2.0.2, < 6.0)
+    base64 (0.2.0)
     claide (1.1.0)
     claide-plugins (0.9.2)
       cork
       nap
       open4 (~> 1.3)
     colored2 (3.1.2)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.2.2)
     cork (0.3.0)
       colored2 (~> 3.1)
-    danger (8.6.1)
+    danger (9.4.0)
       claide (~> 1.0)
       claide-plugins (>= 0.9.2)
       colored2 (~> 3.1)
       cork (~> 0.1)
-      faraday (>= 0.9.0, < 2.0)
+      faraday (>= 0.9.0, < 3.0)
       faraday-http-cache (~> 2.0)
-      git (~> 1.7)
+      git (~> 1.13)
       kramdown (~> 2.3)
       kramdown-parser-gfm (~> 1.0)
       no_proxy_fix
-      octokit (~> 4.7)
+      octokit (>= 6.0, < 8.0)
       terminal-table (>= 1, < 4)
     differ (0.1.2)
     et-orbi (1.2.7)
       tzinfo
-    faraday (1.10.0)
-      faraday-em_http (~> 1.0)
-      faraday-em_synchrony (~> 1.0)
-      faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0)
-      faraday-multipart (~> 1.0)
-      faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.0)
-      faraday-patron (~> 1.0)
-      faraday-rack (~> 1.0)
-      faraday-retry (~> 1.0)
+    faraday (2.7.11)
+      base64
+      faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
-    faraday-em_http (1.0.0)
-    faraday-em_synchrony (1.0.0)
-    faraday-excon (1.1.0)
-    faraday-http-cache (2.4.0)
+    faraday-http-cache (2.5.0)
       faraday (>= 0.8)
-    faraday-httpclient (1.0.1)
-    faraday-multipart (1.0.4)
-      multipart-post (~> 2)
-    faraday-net_http (1.0.1)
-    faraday-net_http_persistent (1.2.0)
-    faraday-patron (1.0.0)
-    faraday-rack (1.0.0)
-    faraday-retry (1.0.3)
-    fugit (1.5.3)
+    faraday-net_http (3.0.2)
+    fugit (1.9.0)
       et-orbi (~> 1, >= 1.2.7)
       raabro (~> 1.4)
-    git (1.11.0)
+    git (1.18.0)
+      addressable (~> 2.8)
       rchardet (~> 1.8)
     kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    liquid (5.3.0)
+    liquid (5.4.0)
     logger-colors (1.0.0)
-    mini_portile2 (2.8.0)
-    multipart-post (2.2.3)
+    mini_portile2 (2.8.5)
     nap (1.1.0)
     no_proxy_fix (0.1.2)
-    nokogiri (1.13.7)
-      mini_portile2 (~> 2.8.0)
+    nokogiri (1.15.4)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    octokit (4.25.1)
+    octokit (7.2.0)
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
     open4 (1.3.4)
-    pmdtester (1.5.1)
+    pmdtester (1.5.5)
       differ (~> 0.1)
-      liquid (~> 5.2)
+      liquid (~> 5.4)
       logger-colors (~> 1.0)
       nokogiri (~> 1.13)
       rufus-scheduler (~> 3.8)
-      slop (~> 4.6)
-    public_suffix (4.0.7)
+      slop (~> 4.9)
+    public_suffix (5.0.3)
     raabro (1.4.0)
-    racc (1.6.0)
+    racc (1.7.3)
     rchardet (1.8.0)
-    rexml (3.2.5)
-    rouge (3.29.0)
+    rexml (3.2.6)
+    rouge (4.2.0)
     ruby2_keywords (0.0.5)
-    rufus-scheduler (3.8.2)
+    rufus-scheduler (3.9.1)
       fugit (~> 1.1, >= 1.1.6)
     safe_yaml (1.0.5)
     sawyer (0.9.2)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
-    slop (4.9.2)
+    slop (4.10.1)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
-    tzinfo (2.0.5)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.2.0)
+    unicode-display_width (2.5.0)
 
 PLATFORMS
   ruby
@@ -113,4 +96,4 @@ DEPENDENCIES
   safe_yaml
 
 BUNDLED WITH
-   2.1.4
+   2.4.5

README.md

@@ -1,13 +1,15 @@
 # PMD - source code analyzer
 
-[![Join the chat at https://gitter.im/pmd/pmd](https://badges.gitter.im/pmd/pmd.svg)](https://gitter.im/pmd/pmd?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+![PMD Logo](https://raw.githubusercontent.com/pmd/pmd/pmd/7.0.x/docs/images/logo/pmd-logo-300px.png)
+
+[![Join the chat](https://img.shields.io/gitter/room/pmd/pmd)](https://app.gitter.im/#/room/#pmd_pmd:gitter.im?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Build Status](https://github.com/pmd/pmd/workflows/build/badge.svg?branch=master)](https://github.com/pmd/pmd/actions)
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/net.sourceforge.pmd/pmd/badge.svg)](https://maven-badges.herokuapp.com/maven-central/net.sourceforge.pmd/pmd)
 [![Reproducible Builds](https://img.shields.io/badge/Reproducible_Builds-ok-green?labelColor=blue)](https://github.com/jvm-repo-rebuild/reproducible-central#net.sourceforge.pmd:pmd)
 [![Coverage Status](https://coveralls.io/repos/github/pmd/pmd/badge.svg)](https://coveralls.io/github/pmd/pmd)
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a674ee8642ed44c6ba7633626ee95967)](https://www.codacy.com/app/pmd/pmd?utm_source=github.com&utm_medium=referral&utm_content=pmd/pmd&utm_campaign=Badge_Grade)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/ea550046a02344ec850553476c4aa2ca)](https://www.codacy.com/gh/pmd/pmd/dashboard?utm_source=github.com&utm_medium=referral&utm_content=pmd/pmd&utm_campaign=Badge_Grade)
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](code_of_conduct.md) 
-[![Documentation (latest)](https://img.shields.io/badge/docs-latest-green)](https://pmd.github.io/latest/)
+[![Documentation (latest)](https://img.shields.io/badge/docs-latest-green)](https://docs.pmd-code.org/latest/)
 
 **PMD** is a source code analyzer. It finds common programming flaws like unused variables, empty catch blocks,
 unnecessary object creation, and so forth. It supports many languages. It can be extended with custom rules.
@@ -15,11 +17,13 @@ It uses JavaCC and Antlr to parse source files into abstract syntax trees (AST)
 Rules can be written in Java or using a XPath query.
 
 It supports Java, JavaScript, Salesforce.com Apex and Visualforce,
-Modelica, PLSQL, Apache Velocity, XML, XSL, Scala.
+Modelica, PLSQL, Apache Velocity, HTML, XML and XSL.
+Scala is supported, but there are currently no Scala rules available.
 
-Additionally it includes **CPD**, the copy-paste-detector. CPD finds duplicated code in
-C/C++, C#, Dart, Fortran, Go, Groovy, Java, JavaScript, JSP, Kotlin, Lua, Matlab, Modelica,
-Objective-C, Perl, PHP, PLSQL, Python, Ruby, Salesforce.com Apex, Scala, Swift, Visualforce and XML.
+Additionally, it includes **CPD**, the copy-paste-detector. CPD finds duplicated code in
+C/C++, C#, Dart, Fortran, Gherkin, Go, Groovy, HTML, Java, JavaScript, JSP, Kotlin, Lua, Matlab, Modelica,
+Objective-C, Perl, PHP, PLSQL, Python, Ruby, Salesforce.com Apex and Visualforce, Scala, Swift, T-SQL,
+Apache Velocity, and XML.
 
 In the future we hope to add support for data/control flow analysis and automatic (quick) fixes where
 it makes sense.
@@ -29,9 +33,9 @@ it makes sense.
 Download the latest binary zip from the [releases](https://github.com/pmd/pmd/releases/latest)
 and extract it somewhere.
 
-Execute `bin/run.sh pmd` or `bin\pmd.bat`.
+Execute `bin/pmd check` or `bin\pmd.bat check`.
 
-See also [Getting Started](https://pmd.github.io/latest/pmd_userdocs_installation.html)
+See also [Getting Started](https://docs.pmd-code.org/latest/pmd_userdocs_installation.html)
 
 **Demo:**
 
@@ -40,7 +44,7 @@ This shows how PMD can detect for loops, that can be replaced by for-each loops.
 ![Demo](docs/images/userdocs/pmd-demo.gif)
 
 There are plugins for Maven and Gradle as well as for various IDEs.
-See [Tools / Integrations](https://pmd.github.io/latest/pmd_userdocs_tools.html)
+See [Tools / Integrations](https://docs.pmd-code.org/latest/pmd_userdocs_tools.html)
 
 ## ℹ️ How to get support?
 
@@ -50,8 +54,8 @@ See [Tools / Integrations](https://pmd.github.io/latest/pmd_userdocs_tools.html)
     or on [discussions](https://github.com/pmd/pmd/discussions).
 *   I got this error and I'm sure it's a bug -- file an [issue](https://github.com/pmd/pmd/issues).
 *   I have an idea/request/question -- create a new [discussion](https://github.com/pmd/pmd/discussions).
-*   I have a quick question -- ask on our [Gitter chat](https://gitter.im/pmd/pmd).
-*   Where's your documentation? -- <https://pmd.github.io/latest/>
+*   I have a quick question -- ask in our [Gitter room](https://app.gitter.im/#/room/#pmd_pmd:gitter.im).
+*   Where's your documentation? -- <https://docs.pmd-code.org/latest/>
 
 ## 🤝 Contributing
 

antlr4-wrapper.xml

@@ -0,0 +1,151 @@
+<!--
+  ~ BSD-style license; for more info see http://pmd.sourceforge.net/license.html
+  -->
+
+<project name="pmd" default="adapt-antlr-sources" basedir="../../../../">
+
+<!--    Input properties:
+        - lang-name: matches the grammar name (eg "Swift")
+        - lang-terse-name: uncapitalized package name (eg "swift")
+        - node-prefix: prefix for generated AST nodes (eg "Sw")
+        - root-node-name: name of the root node without prefix (eg "TopLevel"), will be made to implement RootNode
+
+        See AntlrGeneratedParserBase
+
+-->
+
+    <property name="target-package-dir" value="${antlr4.outputDirectory}/net/sourceforge/pmd/lang/${lang-terse-name}/ast"/>
+
+
+    <property name="lang-ast-package" value="net.sourceforge.pmd.lang.${lang-terse-name}.ast" />
+    <property name="ast-api-package" value="net.sourceforge.pmd.lang.ast" />
+    <property name="ast-impl-package" value="${ast-api-package}.impl.antlr4" />
+
+
+    <property name="parser-name" value="${lang-name}Parser"/>
+    <property name="parser-file" value="${target-package-dir}/${parser-name}.java"/>
+
+    <property name="visitor-name" value="${lang-name}Visitor"/>
+    <property name="visitor-file" value="${target-package-dir}/${visitor-name}.java"/>
+
+    <property name="base-visitor-name" value="${lang-name}BaseVisitor"/>
+    <property name="base-visitor-file" value="${target-package-dir}/${base-visitor-name}.java"/>
+
+    <property name="listener-name" value="${lang-name}Listener"/>
+    <property name="listener-file" value="${target-package-dir}/${visitor-name}.java"/>
+
+    <property name="base-listener-name" value="${lang-name}BaseListener"/>
+    <property name="base-listener-file" value="${target-package-dir}/${base-visitor-name}.java"/>
+
+    <property name="node-itf-name" value="${lang-name}Node"/>
+    <property name="base-class-name" value="Abstract${lang-name}Node"/>
+
+    <condition property="rename-parser">
+        <and>
+            <not>
+                <available file="${parser-file}"/>
+            </not>
+            <available file="${target-package-dir}/${lang-name}.java"/>
+        </and>
+    </condition>
+
+    <target name="rename-parser" description="Rename the parser to our conventional name if needed"
+            if="rename-parser">
+        <replace file="${target-package-dir}/${lang-name}.java">
+            <replacefilter token="class ${lang-name} "
+                           value="class ${parser-name} "/>
+            <replacefilter token="public ${lang-name}(TokenStream input)"
+                           value="public ${parser-name}(TokenStream input)"/>
+        </replace>
+        <replace dir="${target-package-dir}">
+            <include name="${lang-name}.java"/>
+            <include name="${visitor-name}.java"/>
+            <include name="${base-visitor-name}.java"/>
+            <include name="${listener-name}.java"/>
+            <include name="${base-listener-name}.java"/>
+            <replacefilter token="${lang-name}." value="${parser-name}."/>
+        </replace>
+
+        <move file="${target-package-dir}/${lang-name}.java"
+              tofile="${parser-file}"/>
+    </target>
+
+    <target name="cpd-language" description="Adapt Antlr sources for CPD-only languages">
+        <!-- We only need the Lexer file. -->
+        <delete file="${parser-file}"/>
+        <delete>
+            <fileset dir="${target-package-dir}">
+                <include name="*"/>
+                <exclude name="*Lexer.java"/>
+            </fileset>
+        </delete>
+    </target>
+
+    <target name="pmd-language" description="Adapt Antlr sources for PMD languages" depends="rename-parser">
+
+        <!-- Adapt parser. -->
+        <replace file="${parser-file}">
+            <replacefilter token="${root-node-name}Context extends ${lang-name}InnerNode"
+                           value="${root-node-name}Context extends ${lang-name}RootNode"/>
+
+            <replacefilter token="_ctx = _localctx;"
+                           value="_ctx = _localctx.asAntlrNode();"/>
+
+            <replacefilter token="public &lt;T> T accept(ParseTreeVisitor&lt;? extends T> visitor)"
+                           value="public &lt;P, R> R acceptVisitor(AstVisitor&lt;? super P, ? extends R> visitor, P data)" />
+
+            <replacefilter token="((${visitor-name}&lt;? extends T>)visitor)"
+                           value="((${visitor-name}&lt;? super P, ? extends R>) visitor)" />
+
+            <replacefilter token="return visitor.visitChildren(this);"
+                           value="return super.acceptVisitor(visitor, data);" />
+
+        </replace>
+
+        <replaceregexp flags="g" file="${parser-file}">
+            <regexp pattern="\.visit(\w++)\(this\);"/>
+            <substitution expression=".visit\1(this, data);"/>
+        </replaceregexp>
+
+        <replaceregexp flags="g" file="${parser-file}">
+            <regexp pattern="_sempred\(\((\w+)\)_localctx,"/>
+            <substitution expression="_sempred\((\1) asPmdNode(_localctx),"/>
+        </replaceregexp>
+
+        <!-- Transform the visitor to PMD-style. -->
+        <replace file="${visitor-file}">
+
+            <replacefilter token="Visitor&lt;T> extends ParseTreeVisitor&lt;T> {"
+                           value="Visitor&lt;P, R> extends net.sourceforge.pmd.lang.ast.AstVisitor&lt;P, R> {&#10;
+&#10;
+    /**&#10;
+     * The default visit method for ${lang-name} nodes. Unless overridden,&#10;
+     * the default implementations of the methods of this interface delegate&#10;
+     * to this method. The default calls {@link #visitNode(Node, Object)}.&#10;
+     * &#10;
+     * @param node Node to visit&#10;
+     * @param data Parameter of the visit&#10;
+     * @return Result of the visit&#10;
+     */&#10;
+     default R visit${node-itf-name}(${node-itf-name} node, P data) { return visitNode(node, data); }&#10;&#10;
+&#10;
+"/>
+
+            <replacefilter token="T visit" value="default R visit"/>
+            <replacefilter token="ctx);" value="node, P data) { return visit${node-itf-name}(node, data); }"/>
+
+        </replace>
+
+        <!-- This is in the main sources (not much to do). -->
+        <delete file="${base-visitor-file}" />
+
+
+        <replaceregexp flags="g">
+            <fileset dir="${target-package-dir}" />
+            <regexp pattern="\b([A-Z]\w*)Context\b(?&lt;!\b(Parser)?RuleContext\b)"/>
+            <substitution expression="${node-prefix}\1"/>
+        </replaceregexp>
+
+
+    </target>
+</project>

do-release.sh

@@ -15,17 +15,18 @@ if [ ! -f pom.xml ] || [ ! -d ../pmd.github.io ]; then
     exit 1
 fi
 
-LAST_VERSION=
-RELEASE_VERSION=
-DEVELOPMENT_VERSION=
 CURRENT_BRANCH=
 
 echo "-------------------------------------------"
 echo "Releasing PMD"
 echo "-------------------------------------------"
 
-CURRENT_VERSION=$(./mvnw org.apache.maven.plugins:maven-help-plugin:3.2.0:evaluate -Dexpression=project.version -q -DforceStdout)
-RELEASE_VERSION=${CURRENT_VERSION%-SNAPSHOT}
+# allow to override the release version, e.g. via "RELEASE_VERSION=7.0.0-rc1 ./do-release.sh"
+if [ "$RELEASE_VERSION" = "" ]; then
+    CURRENT_VERSION=$(./mvnw org.apache.maven.plugins:maven-help-plugin:3.2.0:evaluate -Dexpression=project.version -q -DforceStdout)
+    RELEASE_VERSION=${CURRENT_VERSION%-SNAPSHOT}
+fi
+
 MAJOR=$(echo "$RELEASE_VERSION" | cut -d . -f 1)
 MINOR=$(echo "$RELEASE_VERSION" | cut -d . -f 2)
 PATCH=$(echo "$RELEASE_VERSION" | cut -d . -f 3)
@@ -41,15 +42,16 @@ else
     LAST_MINOR="${MINOR}"
     LAST_PATCH=$(("${PATCH}" - 1))
 fi
-LAST_VERSION="$MAJOR.$LAST_MINOR.$LAST_PATCH"
-DEVELOPMENT_VERSION="$MAJOR.$NEXT_MINOR.$NEXT_PATCH"
-DEVELOPMENT_VERSION="${DEVELOPMENT_VERSION}-SNAPSHOT"
 
-# allow to override the next version, e.g. via "NEXT_VERSION=7.0.0 ./do-release.sh"
-if [ "$NEXT_VERSION" != "" ]; then
-    DEVELOPMENT_VERSION="${NEXT_VERSION}-SNAPSHOT"
+# allow to override the next version, e.g. via "DEVELOPMENT_VERSION=7.0.0-SNAPSHOT ./do-release.sh"
+if [ "$DEVELOPMENT_VERSION" = "" ]; then
+    DEVELOPMENT_VERSION="$MAJOR.$NEXT_MINOR.$NEXT_PATCH-SNAPSHOT"
 fi
 
+# allow to override the last version, e.g. via "LAST_VERSION=6.55.0 ./do-release.sh"
+if [ "$LAST_VERSION" = "" ]; then
+    LAST_VERSION="$MAJOR.$LAST_MINOR.$LAST_PATCH"
+fi
 
 # http://stackoverflow.com/questions/1593051/how-to-programmatically-determine-the-current-checked-out-git-branch
 CURRENT_BRANCH=$(git symbolic-ref -q HEAD)
@@ -99,8 +101,8 @@ echo "    the new release based on the release notes. Also add any deprecated ru
 echo
 echo "*   Update **../pmd.github.io/_config.yml** to mention the new release"
 echo
-echo "*   Update property \`pmd-designer.version\` in **pom.xml** to reference the latest pmd-designer release"
-echo "    See <https://search.maven.org/search?q=g:net.sourceforge.pmd%20AND%20a:pmd-ui&core=gav> for the available releases."
+echo "*   Update property \`pmd-designer.version\` in **pom.xml** to reference the version, that will be released"
+echo "    later in this process."
 echo
 echo "Press enter to continue..."
 read -r
@@ -109,14 +111,14 @@ read -r
 # calculating stats for release notes
 
 STATS=$(
-echo "### Stats"
+echo "### 📈 Stats"
 echo "* $(git log pmd_releases/"${LAST_VERSION}"..HEAD --oneline --no-merges |wc -l) commits"
 echo "* $(curl -s "https://api.github.com/repos/pmd/pmd/milestones?state=all&direction=desc&per_page=5"|jq ".[] | select(.title == \"$RELEASE_VERSION\") | .closed_issues") closed tickets & PRs"
 echo "* Days since last release: $(( ( $(date +%s) - $(git log --max-count=1 --format="%at" pmd_releases/"${LAST_VERSION}") ) / 86400))"
 )
 
 TEMP_RELEASE_NOTES=$(cat docs/pages/release_notes.md)
-TEMP_RELEASE_NOTES=${TEMP_RELEASE_NOTES/\{\% endtocmaker \%\}/$STATS$'\n'$'\n'\{\% endtocmaker \%\}$'\n'}
+TEMP_RELEASE_NOTES=${TEMP_RELEASE_NOTES/\{\% endtocmaker \%\}/${STATS//\&/\\\&}$'\n'$'\n'\{\% endtocmaker \%\}$'\n'}
 echo "${TEMP_RELEASE_NOTES}" > docs/pages/release_notes.md
 
 echo
@@ -167,8 +169,9 @@ git commit -a -m "Prepare pmd release ${RELEASE_VERSION}"
     -Dtag="pmd_releases/${RELEASE_VERSION}" \
     -DreleaseVersion="${RELEASE_VERSION}" \
     -DdevelopmentVersion="${DEVELOPMENT_VERSION}" \
-    -Pgenerate-rule-docs
-
+    -DscmCommentPrefix="[release] " \
+    -Darguments='-Pgenerate-rule-docs,!cli-dist' \
+    '-Pgenerate-rule-docs,!cli-dist'
 
 echo
 echo "Tag has been pushed.... now check github actions: <https://github.com/pmd/pmd/actions>"
@@ -217,13 +220,13 @@ This is a {{ site.pmd.release_type }} release.
 
 {% tocmaker is_release_notes_processor %}
 
-### New and noteworthy
+### 🚀 New and noteworthy
 
-### Fixed Issues
+### 🐛 Fixed Issues
 
-### API Changes
+### 🚨 API Changes
 
-### External Contributions
+### ✨ External Contributions
 
 {% endtocmaker %}
 
@@ -232,14 +235,46 @@ EOF
 git commit -a -m "Prepare next development version [skip ci]"
 git push origin "${CURRENT_BRANCH}"
 ./mvnw -B release:clean
+
 echo
 echo
 echo
+echo "*   Wait until the new version is synced to maven central and appears as latest version in"
+echo "    <https://repo.maven.apache.org/maven2/net/sourceforge/pmd/pmd/maven-metadata.xml>."
+echo
+echo
+echo "Then proceed with releasing pmd-designer..."
+echo "<https://github.com/pmd/pmd-designer/blob/master/releasing.md>"
+echo
+echo "Press enter to continue when pmd-designer is available in maven-central..."
+echo "<https://repo.maven.apache.org/maven2/net/sourceforge/pmd/pmd-ui/maven-metadata.xml>."
+read -r
+
+echo
+echo "Continuing with release of pmd-cli and pmd-dist..."
+git checkout "pmd_releases/${RELEASE_VERSION}"
+./mvnw versions:update-parent -DparentVersion="${RELEASE_VERSION}" -DskipResolution=true -DgenerateBackupPoms=false -pl pmd-cli,pmd-dist
+git add pmd-cli/pom.xml pmd-dist/pom.xml
+git commit -m "[release] prepare release pmd_releases/${RELEASE_VERSION}-dist"
+git tag -m "[release] copy for tag pmd_releases/${RELEASE_VERSION}-dist" "pmd_releases/${RELEASE_VERSION}-dist"
+git push origin tag "pmd_releases/${RELEASE_VERSION}-dist"
+git checkout master
+# make sure parent reference is correct
+./mvnw versions:update-parent -DparentVersion="${DEVELOPMENT_VERSION}" -DskipResolution=true -DgenerateBackupPoms=false -pl pmd-cli,pmd-dist
+git add pmd-cli/pom.xml pmd-dist/pom.xml
+changes=$(git status --porcelain 2>/dev/null | grep -c -E "^[AMDRC]" || true)
+if [ "$changes" -gt 0 ]; then
+    git commit -m "Prepare next development version [skip ci]"
+    git push origin "${CURRENT_BRANCH}"
+fi
+
+echo
+echo "Second tag 'pmd_releases/${RELEASE_VERSION}-dist' has been pushed ... now check github actions: <https://github.com/pmd/pmd/actions>"
+echo
+echo
 echo "Verify the new release on github: <https://github.com/pmd/pmd/releases/tag/pmd_releases/${RELEASE_VERSION}>"
 echo "and the news entry at <https://sourceforge.net/p/pmd/news/>"
 echo
-echo "*   Wait until the new version is synced to maven central and appears as latest version in"
-echo "    <https://repo.maven.apache.org/maven2/net/sourceforge/pmd/pmd/maven-metadata.xml>."
 echo "*   Send out an announcement mail to the mailing list:"
 echo
 echo "To: PMD Developers List <pmd-devel@lists.sourceforge.net>"

docs/.gitignore

@@ -5,3 +5,4 @@ _pdf
 .idea/
 vendor/
 .bundle/
+assets/*.zip

docs/Gemfile

@@ -2,3 +2,4 @@ source 'https://rubygems.org'
 
 gem 'jekyll'
 gem 'github-pages'
+gem "webrick"

docs/Gemfile.lock

@@ -1,43 +1,44 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.5.1)
+    activesupport (7.0.8)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    addressable (2.8.5)
+      public_suffix (>= 2.0.2, < 6.0)
+    base64 (0.1.1)
     coffee-script (2.4.1)
       coffee-script-source
       execjs
     coffee-script-source (1.11.1)
     colorator (1.1.0)
-    commonmarker (0.23.5)
-    concurrent-ruby (1.1.10)
-    dnsruby (1.61.9)
-      simpleidn (~> 0.1)
+    commonmarker (0.23.10)
+    concurrent-ruby (1.2.2)
+    dnsruby (1.70.0)
+      simpleidn (~> 0.2.1)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
-    ethon (0.15.0)
+    ethon (0.16.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
-    execjs (2.8.1)
-    faraday (2.3.0)
-      faraday-net_http (~> 2.0)
+    execjs (2.9.1)
+    faraday (2.7.11)
+      base64
+      faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
-    faraday-net_http (2.0.3)
-    ffi (1.15.5)
+    faraday-net_http (3.0.2)
+    ffi (1.16.2)
     forwardable-extended (2.6.0)
     gemoji (3.0.1)
-    github-pages (227)
+    github-pages (228)
       github-pages-health-check (= 1.17.9)
-      jekyll (= 3.9.2)
+      jekyll (= 3.9.3)
       jekyll-avatar (= 0.7.0)
       jekyll-coffeescript (= 1.1.1)
-      jekyll-commonmark-ghpages (= 0.2.0)
+      jekyll-commonmark-ghpages (= 0.4.0)
       jekyll-default-layout (= 0.1.4)
       jekyll-feed (= 0.15.1)
       jekyll-gist (= 1.5.0)
@@ -71,7 +72,7 @@ GEM
       jemoji (= 0.12.0)
       kramdown (= 2.3.2)
       kramdown-parser-gfm (= 1.1.0)
-      liquid (= 4.0.3)
+      liquid (= 4.0.4)
       mercenary (~> 0.3)
       minima (= 2.5.1)
       nokogiri (>= 1.13.6, < 2.0)
@@ -83,17 +84,17 @@ GEM
       octokit (~> 4.0)
       public_suffix (>= 3.0, < 5.0)
       typhoeus (~> 1.3)
-    html-pipeline (2.14.2)
+    html-pipeline (2.14.3)
       activesupport (>= 2)
       nokogiri (>= 1.4)
     http_parser.rb (0.8.0)
-    i18n (0.9.5)
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
-    jekyll (3.9.2)
+    jekyll (3.9.3)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
-      i18n (~> 0.7)
+      i18n (>= 0.7, < 2)
       jekyll-sass-converter (~> 1.0)
       jekyll-watch (~> 2.0)
       kramdown (>= 1.17, < 3)
@@ -109,11 +110,11 @@ GEM
       coffee-script-source (~> 1.11.1)
     jekyll-commonmark (1.4.0)
       commonmarker (~> 0.22)
-    jekyll-commonmark-ghpages (0.2.0)
-      commonmarker (~> 0.23.4)
+    jekyll-commonmark-ghpages (0.4.0)
+      commonmarker (~> 0.23.7)
       jekyll (~> 3.9.0)
       jekyll-commonmark (~> 1.4.0)
-      rouge (>= 2.0, < 4.0)
+      rouge (>= 2.0, < 5.0)
     jekyll-default-layout (0.1.4)
       jekyll (~> 3.0)
     jekyll-feed (0.15.1)
@@ -201,19 +202,19 @@ GEM
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    liquid (4.0.3)
-    listen (3.7.1)
+    liquid (4.0.4)
+    listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.3.6)
-    mini_portile2 (2.8.0)
+    mini_portile2 (2.8.4)
     minima (2.5.1)
       jekyll (>= 3.5, < 5.0)
       jekyll-feed (~> 0.9)
       jekyll-seo-tag (~> 2.1)
-    minitest (5.16.2)
-    nokogiri (1.13.7)
-      mini_portile2 (~> 2.8.0)
+    minitest (5.20.0)
+    nokogiri (1.15.4)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
     octokit (4.25.1)
       faraday (>= 1, < 3)
@@ -221,11 +222,11 @@ GEM
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     public_suffix (4.0.7)
-    racc (1.6.0)
-    rb-fsevent (0.11.1)
+    racc (1.7.1)
+    rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    rexml (3.2.5)
+    rexml (3.2.6)
     rouge (3.26.0)
     ruby2_keywords (0.0.5)
     rubyzip (2.3.2)
@@ -242,16 +243,15 @@ GEM
       unf (~> 0.1.4)
     terminal-table (1.8.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
-    thread_safe (0.3.6)
     typhoeus (1.4.0)
       ethon (>= 0.9.0)
-    tzinfo (1.2.10)
-      thread_safe (~> 0.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
     unf (0.1.4)
       unf_ext
     unf_ext (0.0.8.2)
     unicode-display_width (1.8.0)
-    zeitwerk (2.6.0)
+    webrick (1.8.1)
 
 PLATFORMS
   ruby
@@ -259,6 +259,7 @@ PLATFORMS
 DEPENDENCIES
   github-pages
   jekyll
+  webrick
 
 BUNDLED WITH
-   2.1.4
+   2.4.5

docs/README.md

@@ -1,8 +1,10 @@
 # PMD Documentation
 
-The documentation is available at: <https://pmd.github.io/pmd/>
+The snapshot documentation (build by github pages) is available at: <https://pmd.github.io/pmd/>.
 
-The documentation for the latest release is at: <https://pmd.github.io/latest/>
+The same documentation (build with our own scripts) is available at: <https://docs.pmd-code.org/snapshot/>. 
+
+The documentation for the latest release is at: <https://docs.pmd-code.org/latest/>
 
 ## Site Theme
 

docs/_config.yml

@@ -1,10 +1,10 @@
 repository: pmd/pmd
 
 pmd:
-    version: 6.49.0
-    previous_version: 6.48.0
-    date: 31-August-2022
-    release_type: minor
+    version: 7.0.0-SNAPSHOT
+    previous_version: 6.55.0
+    date: ??-?????-2023
+    release_type: major
 
 # release types: major, minor, bugfix
 
@@ -23,9 +23,6 @@ company_name: PMD Open Source Project
 github_editme_path: pmd/pmd/blob/master/docs/
 # if you're using Github, provide the basepath to the branch you've created for reviews, following the sample here. if not, leave this value blank.
 
-disqus_shortname:
-# if you're using disqus for comments, add the shortname here. if not, leave this value blank.
-
 host: 127.0.0.1
 # the preview server used. Leave as is.
 
@@ -42,10 +39,11 @@ exclude:
   - README.md
   - Dockerfile
   - build-docs.sh
+  - assets/*.zip
+  - assets/README.md
   - pdf-*.sh
   - pdfconfigs/
   - pdf/
-  - sitemap_generator.sh
   - render_release_notes.rb
 
 feedback_subject_line: PMD Source Code Analyzer
@@ -118,7 +116,7 @@ description: "Intended as a documentation theme based on Jekyll for technical wr
 # the description is used in the feed.xml file
 
 # needed for sitemap.xml file only
-url: https://pmd.github.io/pmd
+url: https://docs.pmd-code.org/latest
 baseurl: ""
 
 # used by javadoc_tag.rb

docs/_data/alerts.yml

@@ -1,7 +1,7 @@
-tip: '<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip: </b>'
-note: '<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note: </b>'
-important: '<div class="alert alert-warning" role="alert"><i class="fa fa-warning"></i> <b>Important: </b>'
-warning: '<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning: </b>'
+tip: '<div class="alert alert-success" role="alert"><i class="fas fa-check-square-o"></i> <b>Tip: </b>'
+note: '<div class="alert alert-info" role="alert"><i class="fas fa-info-circle"></i> <b>Note: </b>'
+important: '<div class="alert alert-warning" role="alert"><i class="fas fa-warning"></i> <b>Important: </b>'
+warning: '<div class="alert alert-danger" role="alert"><i class="fas fa-exclamation-circle"></i> <b>Warning: </b>'
 end: '</div>'
 
 callout_danger: '<div class="bs-callout bs-callout-danger">'