Doc updates

[RuthBowyer]

This PR updates the main readme and a few other bits. Thanks!

[andrewphilipsmith]

Hey @RuthBowyer - Looks good! I've added comments to the files, which I've summarised here:

• There are a couple of suggestions about the text itself. Feel free to use these or ignore them as you feel appropriate.
• There is a question about the downloads. It is important to know whether or not these are working as intended before we merge this.
• The linting will need to be fixed. Done

Let me know if there is anything I can do to help.

[andrewphilipsmith]

Nitpicking point - but I would add in the word "spatial", so "much finer resolution" becomes "much finer spatial resolution" (Feel free to ignore).

Suggested change

We make use of the [Convection Permitting Model (CPM)](https://www.metoffice.gov.uk/pub/data/weather/uk/ukcp18/science-reports/UKCP-Convection-permitting-model-projections-report.pdf). This dataset represents a much finer resolution of climate model (2.2km grid) than typical climate-models, representing a step forward in the ability to simulate small scale behavior (in particular 'atmospheric convection'), and the influence of mountains, coastlines and urban areas. As a result, the CPM provides access to credible climate information important for small-scale weather features and also on local (kilometre) scale; which is particularly important for improving our understanding of climate change in cities.

We make use of the [Convection Permitting Model (CPM)](https://www.metoffice.gov.uk/pub/data/weather/uk/ukcp18/science-reports/UKCP-Convection-permitting-model-projections-report.pdf). This dataset represents a much finer spatial resolution of climate model (2.2km grid) than typical climate-models, representing a step forward in the ability to simulate small scale behavior (in particular 'atmospheric convection'), and the influence of mountains, coastlines and urban areas. As a result, the CPM provides access to credible climate information important for small-scale weather features and also on local (kilometre) scale; which is particularly important for improving our understanding of climate change in cities.

[andrewphilipsmith]

Line 65 has a very long sentence which I find hard to follow. A couple of things that aren't clear:

• Why is run 1 selected?
• "the mean, 2nd highest and 2nd lowest daily tasmax" -> implies three ensembles, but four are listed "runs 5, 6, 7 & 8".

One suggestion would be to list the run and their reasons as bullet points (below). Alternatively, a table might help here.

Suggested change

	The UKCP18-CPM is comprised of 12 ensemble members (or runs). In addition to run 1, we selected the runs which represented the mean, 2nd highest and 2nd lowest daily tasmax values across the whole sequence (runs 5, 6, 7 & 8) to provide users with enough uncertainty in their estimates to appropriately assess bias correction methods.
	The UKCP18-CPM is comprised of 12 ensemble members (or runs). We selected a subset of these ensembles for the following reasons:
	* `run 1` - Selected because ....
	* `run 5` - Has the highest/lowest tasmax ....
	* `run 6` - Has the second highest/lowest tasmax ....
	* etc....
	We believe that this combination will provide users with enough uncertainty in their estimates to assess the bias correction methods appropriately.

[andrewphilipsmith]

I'd be interested to know why you changed the region names to lowercase? Is this just cosmetic or did it not work otherwise?

• If it is cosmetic, I'm happy to go with lowercase.
• If the download commands didn't work with the title case, then we need to check this. It implies there is something wrong - possibly a setting in the Azure storage that we need to double-check.

(All the commands use the grep switches -i and -E. It might be appropriate to add a small note to explain the meaning of these and/or point to existing documentation for these standard tools).

[sgreenbury]

Thanks for flagging this @andrewphilipsmith - also happy to go with lowercase. I've taken a look and both title and lower case versions of the example command seem to function as expected.

[RuthBowyer]

Ah thanks folks - I thought when I tried only the lowercase version worked for some reason! But probably I just had a typo in the actual name or something - I will change back!

[sgreenbury]

I think the link to the datasets section might need to be specified as:

Suggested change

	The `clim-recal` pipeline addresses this by providing preprocessed data, including the innovative [UKCP18-CPM datasets](# The Datasets), to facilitate the assessment of these methods on aligned, reprojected data, without requiring the whole (very large) dataset.
	The `clim-recal` pipeline addresses this by providing preprocessed data, including the innovative [UKCP18-CPM datasets](#the-datasets), to facilitate the assessment of these methods on aligned, reprojected data, without requiring the whole (very large) dataset.

[sgreenbury]

Suggested change

	- see our [contributing](docs/contributing.md) section, which includes details on contriubting to the documentation.
	- see our [contributing](docs/contributing.md) section, which includes details on contributing to the documentation.

[sgreenbury]

Thanks for this @RuthBowyer, all looks great! I've just added a few small suggestions in the code above.

[andrewphilipsmith]

LGTM