fixes

Author: forman

.gitignore

@@ -1,4 +1,3 @@
+site/
 .idea/
-
-# Jupyter Notebook
 .ipynb_checkpoints

README.md

@@ -3,3 +3,8 @@
 # DeepESDL documentation
 
 This repository contains the source files for the DeepESDL documentation.
+
+
+## Building the docs
+
+    $ conda install -c conda-forge mkdocs mkapi

docs/design/overview.md

@@ -0,0 +1,7 @@
+# DeepESDL Design Overview
+
+1. [Context](context.md)    
+2. [Architecture](architecture.md)    
+3. [Hub](hub.md)    
+4. [Services and Tools](services-and-tools.md)
+

docs/design/services-and-tools.md

@@ -167,5 +167,7 @@ detection on time series.
 The toolkit is currently for Python only, but Julia will also be 
 considered to address a small but growing community of data scientists.
 
+<!--
 Please refer to the [ML Tools Documentation](../ml-tools/index.md)
 for details.
+-->

docs/index.md

@@ -12,13 +12,13 @@ code, and publish results. Special emphasize is put on improving the support
 for machine learning and artificial intelligence approaches, which includes 
 the preparation of AI-ready datasets, providing a programming environment 
 with relevant libraries and packages, and the resources to execute processing 
-pipelines. Please visit our webportal for more information and access to the 
-lab: [www.earthsystemdatalab.net](www.earthsystemdatalab.net).
+pipelines. For more information and access to the lab please visit the
+[DeepESDL website](https://www.earthsystemdatalab.net/).
 
 The DeepESDL documentation contains:
 
--   The [User Guide](guide/overview.md) for all DeepESDL services – the starting
-    point for new users and the reference for any technical questions.
--   An overview of [public, pre-generated data cubes](datasets/datasets.md)
-    available in DeepESDL with detailed metadata and specifications.
--   A [description of DeepESDL’s architecture](design/index.md).
+* The [User Guide](guide/overview.md) for all DeepESDL services. 
+  This is the starting point for new users.
+* An overview of [public, pre-generated data cubes](datasets/datasets.md)
+  available in DeepESDL with detailed metadata and specifications.
+* A [description of DeepESDL’s architecture](design/overview.md).

mkdocs.yml

@@ -1,6 +1,7 @@
 site_name: DeepESDL Documentation
 site_url: https://deepesdl.readthedocs.io
 repo_url: https://github.com/deepesdl/deepesdl-doc
+edit_uri: edit/main/docs
 copyright: Copyright © 2022 by the DeepESDL Team
 theme: readthedocs  # alternative: mkdocs