update readme and links for 3.17.0 release (engine-3.17)[demos]

doc/adv-manual/classical_PSHA.rst

@@ -490,7 +490,7 @@ Here `set_between_epsilon` is simply shifting the mean with the formula
 will likely grow more methods. If you want to understand how it works you
 should look at the source code:
 
-https://github.com/gem/oq-engine/blob/master/openquake/hazardlib/gsim/mgmpe/modifiable_gmpe.py
+https://github.com/gem/oq-engine/blob/engine-3.17/openquake/hazardlib/gsim/mgmpe/modifiable_gmpe.py
 
 MultiPointSources
 =============================

doc/adv-manual/event_based.rst

@@ -227,7 +227,7 @@ in the asset loss table, in the column "variance", by using the formulae
 in terms of the variance of each asset for the event and intensity level in
 consideration, extracted from the asset loss and the
 coefficients of variation. People interested in the details should look at
-the implementation in https://github.com/gem/oq-engine/blob/master/openquake/risklib/scientific.py.
+the implementation in https://github.com/gem/oq-engine/blob/engine-3.17/openquake/risklib/scientific.py.
 
 The asset loss table
 ====================

doc/adv-manual/general.rst

@@ -292,7 +292,7 @@ to happen when generating tens of thousands of tasks. Again, it is
 best not to touch this parameter unless you know what you are doing.
 
 .. _equivalent distance approximation: special-features.html#equivalent-epicenter-distance-approximation
-.. _rupture radius: https://github.com/gem/oq-engine/blob/master/openquake/hazardlib/source/point.py
+.. _rupture radius: https://github.com/gem/oq-engine/blob/engine-3.17/openquake/hazardlib/source/point.py
 .. _point source gridding: point-source-gridding.html
 
 Developing with the engine
@@ -345,10 +345,10 @@ development installation in Python: you should clone the engine repository,
 create and activate a virtualenv and then perform a `pip install -e .`
 from the engine main directory, as normal. You can find the details here:
 
-https://github.com/gem/oq-engine/blob/master/doc/installing/development.md
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/installing/development.md
 
 It is also possible to develop on Windows (
-https://github.com/gem/oq-engine/blob/master/doc/installing/development.md)
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/installing/development.md)
 but very few people in GEM are doing that, so you are on your own, should you
 encounter difficulties. We recommend Linux, but Mac also works.
 
@@ -657,7 +657,7 @@ compare with the values in the verification table:
 *sig* refers to the "TOTAL_STDDEV", *tau* to the "INTER_EVENT_STDDEV"
 and *phi* to the "INTRA_EVENT_STDDEV". This is how the tests
 in hazardlib are implemented. Interested users should look at the
-code in https://github.com/gem/oq-engine/blob/master/openquake/hazardlib/tests/gsim/utils.py.
+code in https://github.com/gem/oq-engine/blob/engine-3.17/openquake/hazardlib/tests/gsim/utils.py.
 
 Running the engine tests
 ----------------------------------
@@ -786,7 +786,7 @@ The WebUI provides a REST API that can be used in third party
 applications: for instance a QGIS plugin could download the maps
 generated by the engine via the WebUI and display them. There is lot
 of functionality in the API which is documented here:
-https://github.com/gem/oq-engine/blob/master/doc/web-api.md. It is
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/web-api.md. It is
 possible to build your own user interface for the engine on top of it,
 since the API is stable and kept backward compatible.
 

doc/engine-releases.md

@@ -36,7 +36,7 @@ be careful about that.
 
 The recommended way to install a non-LTS release is via the
 universal installer (see
-https://github.com/gem/oq-engine/blob/master/doc/installing/universal.md)
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/installing/universal.md)
 and we do not provide Linux packages nor Windows installer.
 
 While we try very hard to ensure that the QGIS plugin and the web

doc/implementing-new-gsim.md

@@ -14,7 +14,7 @@ https://github.com/gem/oq-engine/tree/master/openquake/hazardlib/gsim
 
 - Create verification tables following the examples that you find here:
 https://github.com/gem/oq-engine/tree/master/openquake/hazardlib/tests/gsim/data
-Usually we create verification tables using an independent code provided by the original authors of the new GSIM. If this is not possible - if available - we use an independent implementation available within code accessible on the web. If verification tables are missing, this must be clearly stated as in this example https://github.com/gem/oq-engine/blob/master/openquake/hazardlib/gsim/raghukanth_iyengar_2007.py#L119
+Usually we create verification tables using an independent code provided by the original authors of the new GSIM. If this is not possible - if available - we use an independent implementation available within code accessible on the web. If verification tables are missing, this must be clearly stated as in this example https://github.com/gem/oq-engine/blob/engine-3.17/openquake/hazardlib/gsim/raghukanth_iyengar_2007.py#L119
 
 - Create tests for the new GSIM using the examples available here 
 https://github.com/gem/oq-engine/tree/master/openquake/hazardlib/tests/gsim
@@ -27,7 +27,7 @@ pytest -xv openquake/hazardlib
 ```
 
 - Update the following .rst file (needed to generate automatically documentation):
-https://github.com/gem/oq-engine/blob/master/doc/sphinx/openquake.hazardlib.gsim.rst
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/sphinx/openquake.hazardlib.gsim.rst
 
 - Check that the new code fulfils PEP 8 standards (usually we do this using tools such as flake8 https://pypi.python.org/pypi/flake8) 
 https://www.python.org/dev/peps/pep-0008/
@@ -37,4 +37,4 @@ https://www.python.org/dev/peps/pep-0008/
 Therefore assignment statements such as REQUIRES_RUPTURE_PARAMETERS = {'mag'} and REQUIRES_RUPTURE_PARAMETERS = set() are both correct.
 
 - Update the changelog file 
-https://github.com/gem/oq-engine/blob/master/debian/changelog following the [Developers notes](updating-the-changelog.md)
+https://github.com/gem/oq-engine/blob/engine-3.17/debian/changelog following the [Developers notes](updating-the-changelog.md)

doc/manual/hazard.rst

@@ -2612,7 +2612,7 @@ quantiles) are supported by all the calculators.
 By default, OpenQuake will export only the statistical results, i.e.
 mean curves and quantiles. If the user requires the complete results for
 all realizations, there is a flag to specify, please see the FAQ
-https://github.com/gem/oq-engine/blob/master/doc/faq-hazard.md. Beware
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/faq-hazard.md. Beware
 that if the logic tree contains a large number of end branches the
 process of exporting the results from each end *Branch* can add a
 significant amount of time - possibly longer than the computation time -

doc/manual/introduction.rst

@@ -39,15 +39,15 @@ can be installed in several different ways. The following page provides
 a handy guide for users to choose the most appropriate installation
 method depending on their intended use cases:
 
-https://github.com/gem/oq-engine/blob/master/doc/installing/README.md.
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/installing/README.md.
 
 This user manual is for the command line interface for the OpenQuake engine.
 
 Supplementary resources
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 Guidance instructions for using the OpenQuake engine WebUI are available at
-https://github.com/gem/oq-engine/blob/master/doc/running/server.md.
+https://github.com/gem/oq-engine/blob/engine-3.17/doc/running/server.md.
 
 A user manual for the QGIS plugin for the OpenQuake engine is available at
 https://docs.openquake.org/oq-irmt-qgis/latest/. In particular,

doc/sphinx/baselib.rst

@@ -26,7 +26,7 @@ $ pip install openquake.engine
 ```
 
 or in several other ways, see
-https://github.com/gem/oq-engine/blob/master/README.md#installation
+https://github.com/gem/oq-engine/blob/engine-3.17/README.md#installation
 
 License
 -------

doc/sphinx/hazardlib.rst

@@ -33,7 +33,7 @@ support on IRC channel #openquake on freenode.
 Installation
 ------------
 
-See https://github.com/gem/oq-engine/blob/master/README.md#installation
+See https://github.com/gem/oq-engine/blob/engine-3.17/README.md#installation
 
 License
 -------