Document how to run a local analysis

Author: JohT

COMMANDS.md

@@ -4,20 +4,27 @@
 
 Use the following commands in the root directory of this repository to start an analysis manually e.g. for [AxonFramework](./scripts/artifacts/downloadAxonFramework.sh).
 
-### Notes
-
-- Be sure to use Java 11 (June 2023 Neo4j 4.x requirement)
-- Use your own initial Neo4j password
-- It uses the script [analyze.sh](./scripts/analysis/analyze.sh)
-- The script file names (without the prefix "download" and without the file extension) in the directory [scripts/artifacts](./scripts/artifacts) provide the possible analysis names.
-
-
 ```shell
 export NEO4J_INITIAL_PASSWORD=theinitialpasswordthatihavechosenforneo4j
 mkdir -p ./temp
-./../scripts/analysis/analyze.sh --name AxonFramework --version 4.7.5 --report All
+cd temp
+./../scripts/analysis/analyze.sh --name AxonFramework --version 4.8.0
 ```
 
+Add the command line argument `--report Csv` to only run the CSV reports when you don't have Python set up
+or want to skip Jupyter Notebooks.
+
+Add the command line argument `--profile Neo4jv4` if you want to use the older long term support (june 2023)
+version v4.4.x of Neo4j and compatible versions of plugins and JQAssistant.
+
+### Notes
+
+- Be sure to use Java 11 (Mai 2023 Neo4j v4 requirement) or Java 17 (June 2023 Neo4j v5 and jQAssistant CLI v2)
+- Use your own initial Neo4j password
+- For more details have a look at the script [analyze.sh](./scripts/analysis/analyze.sh)
+- The script file names (without the prefix "download" and without the file extension) in the directory [scripts/artifacts](./scripts/artifacts) provide all analysis names that are available.
+
+
 Have a look at [code-reports.yml](./.github/workflows/code-reports.yml) for all details about setup steps and full automation.
 
 ## Generate Markdown References

README.md

@@ -75,6 +75,9 @@ The [Code Reports Pipeline](./.github/workflows/code-reports.yml) utilizes [GitH
 
 ## 🤔 Questions & Answers
 
+- How can i run an analysis locally?  
+👉 See [start-an-analysis](./COMMANDS.md#start-an-analysis) in the [Commands Reference](./COMMANDS.md).
+
 - How can i add an CSV report to the pipeline?  
 👉 Put your new cypher query into the [cypher](./cypher) directory or a suitable (new) sub directory.  
 👉 Create a new CSV report script in the [scripts/reports](./scripts/reports/) directory. Take for example [OverviewCsv.sh](./scripts/reports/OverviewCsv.sh) as a reference.