Make user configuration file more user friendly about esmvalcore

[ledm]

At our tutorial, @rjp23 has brought up the issues with the config-user.yml.

It's frustrating that users need to edit this file, but the documentation is not explicit. There should be a big red banner somewhere about it.

It should be easier for users to get started. Would it be possible to include the correct rootpath variables, but commented out in the standard user-config.yml?

Alternatively, perhaps there is an even better solution where the rootpaths are instead defined in config-developpers.yml so that user's don't have to define standardised paths in their config-user.yml (if they're working on a standard machine like jasmin) file?

[bouweandela]

Related issues ESMValGroup/ESMValTool#1278, #100, #125, #93, ESMValGroup/ESMValTool#1622

[bouweandela]

It's frustrating that users need to edit this file, but the documentation is not explicit. There should be a big red banner somewhere about it.

@ledm Note that pretty extensive documentation is now available here: https://esmvaltool.readthedocs.io/projects/esmvalcore/en/latest/quickstart/find_data.html
However, this really should be linked from https://esmvaltool.readthedocs.io/en/latest/quickstart/configuration.html

[schlunma]

Can this be closed? I think most of the issues listed are solved.

[bouweandela]

Yes, except for automatically finding out which cluster we're on, but let's close this.

[bouweandela]

Unless you would like to keep it open @ledm?