Tweak docs (#4)

* Explain use case * Mention two usecases * Update example
ESM-VFC · Feb 6, 2021 · d9eec2b · d9eec2b
1 parent a3d0ebb
commit d9eec2b
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 4 deletions.
diff --git a/README.md b/README.md
@@ -1,10 +1,13 @@
-# Intake Zenodo Fetcher
+# Intake Zenodo Fetcher: _Fetch data from Zenodo based on Intake catalog entries_
 
 [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/ESM-VFC/intake_zenodo_fetcher/main?filepath=examples/fetch_based_on_zenodo_doi.ipynb)
 
-Fetch data from Zenodo based on Intake catalog entries
+## Why?
 
-See [examples/fetch_based_on_zenodo_doi.ipynb](https://nbviewer.jupyter.org/github/ESM-VFC/intake_zenodo_fetcher/blob/main/examples/fetch_based_on_zenodo_doi.ipynb) for a demo on pre-fetching the data based on a Zenodo DOI.
+To improve reproducibility of workflows that use data archived on Zenodo, `intake_zenodo_fetcher` simplifies downloading a local copy of the data belonging to a Zenodo DOI.
+It offers functions to fetch _all_ data baloginging to a Zenodo DOI and it allows for restricting the download to just those parts of the Zenodo record that belong to a catalog entry in an Intake catalog.
+
+See [examples/fetch_based_on_zenodo_doi.ipynb](https://nbviewer.jupyter.org/github/ESM-VFC/intake_zenodo_fetcher/blob/main/examples/fetch_based_on_zenodo_doi.ipynb) for a demo on pre-fetching the data based on a Zenodo DOI or [try it live on `mybinder.org`](https://mybinder.org/v2/gh/ESM-VFC/intake_zenodo_fetcher/main?filepath=examples/fetch_based_on_zenodo_doi.ipynb).
 
 ## Installation