Merge branch 'examples-point-to-5.2.0' into 'main'

Examples point to 5.2.0

Closes #556

See merge request !712

etc/examples/5-complex-model/README.md

@@ -15,11 +15,23 @@ alias hazard='java -Xms4g -Xmx8g -cp /path/to/nshmp-haz/build/libs/nshmp-haz.jar
 This will increase the minimum amount of memory Java requires to 4GB and will allow it to claim
 up to 8GB, assuming that much is available.
 
-First, clone the CONUS NSHM repository. Assuming you are in the current working directory
-(above), the following will create a copy of the model adjacent to nshmp-haz:
+First, download the
+[CONUS NSHM version 5.2.0](https://code.usgs.gov/ghsc/nshmp/nshms/nshm-conus/-/archive/5.2.0/nshm-conus-5.2.0.zip)
+and unzip adjacent to nshmp-haz. Note that in subsequent examples, the name of the model
+should match the unzipped directory name (e.g. `../../../../nshm-conus-5.2.0`).
+
+Alternatively, clone the CONUS NSHM repository. The `main` branch is under active development and
+may break some of the examples, so you need to checkout a stable version of the NSHM. Assuming you
+are in the current working directory (above), the following will create a copy of the model
+adjacent to nshmp-haz and checkout version 5.2.0. See [CONTRIBUTING.md](../../../CONTRIBUTING.md)
+for more information about contributing to nshmp-haz or nshm-conus.
 
 ```Shell
 git clone https://code.usgs.gov/ghsc/nshmp/nshms/nshm-conus.git ../../../../nshm-conus
+cd ../../../../nshm-conus
+git fetch origin refs/tags/5.2.0
+git checkout -b ver-5.2.0 5.2.0
+cd ../nshmp-haz/etc/examples/5-complex-model
 ```
 
 To compute hazard for a few sites at 1.0s and 2.0s spectral periods, execute:

etc/examples/6-enhanced-output/README.md

@@ -4,8 +4,8 @@ __Working directory:__ `/path/to/nshmp-haz/etc/examples/6-enhanced-output`
 
 While mean hazard is of broad interest, it can be useful to preserve individual components of a
 total curve, particularly with more complex models. Execute the following to write curves for
-each source type and ground motion model (GMM) used in the CONUS NSHM (cloned in the previous
-example):
+each source type and ground motion model (GMM) used in the CONUS NSHM (downloaded and unzipped,
+or cloned in the previous example - use version 5.2.0):
 
 ```Shell
 hazard ../../../../nshm-conus sites.geojson config.json

etc/examples/7-disaggregation/README.md

@@ -20,7 +20,7 @@ seem to occur if `nshmp-haz` is built and run in the Windows Subsystem for Linux
 The command line arguments for `DisaggCalc` are the same as those for `HazardCalc`. The target
 return period for a disaggregation is specified in the config
 [`disagg.returnPeriod`](../../../docs/pages/Calculation-Configuration.md#calculation-configuration-parameters)
-field. For compute the disaggregation in this example, execute:
+field. To compute the disaggregation in this example (use NSHM CONUS v5.2.0), execute:
 
 ```Shell
 disagg ../../../../nshm-conus sites.csv config.json