Start on download docs

Author: znichollscr

docs/index.md

@@ -5,7 +5,7 @@
 For: 
 
 - different, pre-prepared views of the database, see [database views](database-views/index.md)
-- usage as a data user, see [usage - data user](usage-data-user.md)
+- usage as a data user, see [usage - data user](usage-data-user/index.md)
 - usage as a data producer, see [usage - data producer](usage-data-producer.md)
 - an overview of the repository, see [repository overview](repository-overview.md)
 - guidance on how to contribute to the repository, see [contributing](contributing.md)

docs/usage-data-user/downloading.md

@@ -0,0 +1,15 @@
+# Downloading data
+
+Here we provide some examples of how to download data.
+They are not meant to be exhaustive, but they may help.
+
+## esgpull
+
+<!-- TODO: Zeb to write -->
+
+- use the example of [https://github.com/climate-resource/CMIP6-vs-CMIP7-GHG-Concentrations]()
+  which uses esgpull
+
+## Directly from ESGF
+
+<!-- I have no idea what guidance is, I only use the GUI, Paul? -->

docs/usage-data-user.md docs/usage-data-user/index.mddocs/usage-data-user.md renamed to docs/usage-data-user/index.md

@@ -10,22 +10,22 @@ so please don't hesitate to ask.
 ## The datasets
 
 An overview of each dataset, with links to further information,
-can be found in [dataset overviews](dataset-overviews/index.md).
+can be found in [dataset overviews](../dataset-overviews/index.md).
 
 ## Navigating the database
 
 The database tracks all of the files[^1] being managed in the input4MIPs project[^2].
 In general, as a user, you won't be interested in information at the level of individual files,
 hence we provide different views.
 An overview of these is given in the
-[database views homepage](database-views/index.md).
+[database views homepage](../database-views/index.md).
 Here we provide some more targeted guidance for users of the data.
 
 [^1]: At the moment, just data from the 'CMIP6Plus' era, but we hope to expand this out to data from the CMIP6 era in future.
 [^2]: Yes, this does somewhat duplicate the point of the ESGF index, but the ESGF index isn't publically accessible/queriable and doesn't have all the information we want right now, so here we are.
 
 If you want to know about the latest status of each dataset,
-have a look at [the delivery summary](database-views/input4MIPs_delivery-summary_CMIP6Plus.html).
+have a look at [the delivery summary](../database-views/input4MIPs_delivery-summary_CMIP6Plus.html).
 This page provides, for each forcing dataset:
 
 - its current status (see the `Status` column)
@@ -44,7 +44,7 @@ This page provides, for each forcing dataset:
 
 Beyond the overviews above, you can also use the different views of our database.
 If you are interested in the status of different versions of a particular dataset,
-then it is worth looking at [the source ID level view](database-views/input4MIPs_source-id_CMIP6Plus.html).
+then it is worth looking at [the source ID level view](../database-views/input4MIPs_source-id_CMIP6Plus.html).
 Within this view, the search bar can be used to filter just for the dataset you're interested in.
 Once this filtering is done, a few columns are particularly relevant:
 
@@ -59,9 +59,9 @@ Once this filtering is done, a few columns are particularly relevant:
   (either because it was never been published or because it has been retracted post-publication).
 
 If you wish to dive even further, you can use
-[the dataset level view](database-views/input4MIPs_datasets_CMIP6Plus.html)
+[the dataset level view](../database-views/input4MIPs_datasets_CMIP6Plus.html)
 to get information at the level of individual datasets (generally, variable-level)
-and [the file level view](database-views/input4MIPs_files_CMIP6Plus.html)
+and [the file level view](../database-views/input4MIPs_files_CMIP6Plus.html)
 to get information at the level of individual files (unlikely to be of use in the majority of cases).
 
 ## CVs

mkdocs.yml

@@ -9,7 +9,9 @@ repo_url: https://github.com/PCMDI/input4MIPs_CVs
 nav:
   - input4MIPs CVs: index.md
   - Usage:
-    - As a data user: usage-data-user.md
+    - As a data user: 
+      - Overview: usage-data-user/index.md
+      - Downloading data: usage-data-user/downloading.md
     - As a data producer: usage-data-producer.md
   - Dataset overviews:
     - Summary: dataset-overviews/index.md