[JOSE] Documentation/Readme possible improvements

[BenjMy]

xref https://github.com/openjournals/jose-reviews/issues/185

• README

  • Make clear that Gempy is an optional dependency in the README.
  • Identify the target audience in the docs and in the README.
  • Add briefly FAIR principles adopted for the datasets

• Documentation:

  • The installation section is a bit confusing. I would only add 2 clear installations: (1) Installing using Conda/Pip (2) Installation of a developer version. Particularly I don't understand why you recommend "installing Gemgis dependencies manually" after "Installing GemGIS via conda-forge". I would expect the required dependencies installed automatically. Notebooks recommandations
  • See https://github.com/cgre-aachen/gemgis_data/issues/18
  • I often found very useful to have a button to be able to download the notebook directly from the documentation (see Sphinx doc).

[jwagemann]

• The repository misses a description on dependencies and environment settings via e.g. an environment.yml file → how can I replicate the setup to have the notebooks of the tutorial running?
• The link to the binder does not open an environment where I can run the tutorial notebooks → it leads to the GemGIS binder setup
• I cannot see a version indicated on the repository
• License of repository (GPL 3.0) and license identified on the notebooks (CC-BY) differ

[AlexanderJuestel]

Also, here a list of your comments to track my progress of the revision:

• [x] Make clear that Gempy is an optional dependency in the README.

• [x] Identify the target audience in the docs and in the README.

• [x] Add briefly FAIR principles adopted for the datasets

• [x] The installation section is a bit confusing. --> Fixing the installation

• [x] I often found very useful to have a button to be able to download the notebook directly from the documentation (see Sphinx doc).

• [x] The repository misses a description on dependencies

• [x] The repository misses a description environment settings via e.g. an environment.yml file → how can I replicate the setup to have the notebooks of the tutorial running?

• [ ] The link to the binder does not open an environment where I can run the tutorial notebooks → it leads to the GemGIS binder setup

• [x] I cannot see a version indicated on the repository

• [ ] License of repository (GPL 3.0) and license identified on the notebooks (CC-BY) differ