Improve PMD update procedure

.github/workflows/build.yml

@@ -14,6 +14,9 @@ jobs:
       matrix:
         os: [macos-latest, ubuntu-latest, windows-latest]
     runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        shell: bash
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-node@v4

.gitignore

@@ -2,7 +2,9 @@ out
 node_modules
 .sfdx
 .vscode-test
+bin/pmd
 bin/pmd.zip
 pmd-packager/target
 *.vsix
 dist/
+test/assets/project2 - with space/pmd-copy

.npmrc

@@ -0,0 +1 @@
+script-shell=bash

CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added
 ### Changed
+
+- Improve PMD update procedure by @adangel in [#174](https://github.com/ChuckJonas/vscode-apex-pmd/pull/174)
+
 ### Deprecated
 ### Removed
 ### Fixed

README.md

@@ -67,17 +67,33 @@ this output channel.
 
 ## Developing/Contributing
 
+### Prerequisites
+
+* node
+* bash: npm calls shell scripts and therefore bash is needed. Under Windows, make sure to run npm from within git-bash.
+* java: needs to be installed already. It is needed for executing PMD later on.
+
 ### Setup & Run
 
 1. `git clone`
 1. `npm install`
 1. debug -> `run extension`
 
+### Creating a installable vsix package
+
+`npm run vscode:package`
+
+This will create a file "apex-pmd-<version>.vsix", which can be directly installed in VS Code.
+
+### Executing automated tests
+
+`npm run test`
+
 ### Upgrading PMD
 
 `npm run update-pmd`
 
-Any pull request submitted with updates to PMD MUST BE "CHECKSUMED"!
+This will check for the latest PMD version on github and update `config.pmdVersion` in `package.json`.
 
 ## Legal Stuff