DOC: Split docs into three main sections

skipci

Author: cortadocodes

docs/creating.md renamed to docs/creating_services/getting_started.md

@@ -9,6 +9,6 @@ Before you begin, ensure you:
 - Are familiar with Python and the command line
 - Have the following tools installed:
     - Python >= 3.10
-    - The `octue` python library / CLI (see [installation instructions](installation.md))
+    - The `octue` python library / CLI (see [installation instructions](../installation.md))
 
 <!-- prettier-ignore-end -->

docs/infrastructure.md renamed to docs/managing_infrastructure/getting_started.md

@@ -27,4 +27,4 @@ Follow the instructions [here](https://github.com/octue/terraform-octue-twined-c
 
 ## Next steps
 
-Congratulations on setting up a Twined services network! Next up, [create your first data service](creating.md).
+Congratulations on setting up a Twined services network! Next up, [create your first data service](../creating_services/getting_started.md).

docs/getting_started.md renamed to docs/using_services/getting_started.md

@@ -17,7 +17,7 @@ Before you begin, ensure you:
 - Are familiar with Python and/or the command line
 - Have the following tools installed:
     - Python >= 3.10
-    - The `octue` python library / CLI (see [installation instructions](installation.md))
+    - The `octue` python library / CLI (see [installation instructions](../installation.md))
 
 <!-- prettier-ignore-end -->
 
@@ -123,8 +123,8 @@ The following command asks a question to the local example data service.
 
 Congratulations on running your first analysis! For additional information, check out the following resources:
 
-- [Set up infrastructure for a data service(s) using Terraform](infrastructure.md)
-- [Create a data service](creating.md)
+- [Set up infrastructure for a data service(s) using Terraform](../managing_infrastructure/getting_started.md)
+- [Create a data service](../creating_services/getting_started.md)
 - Run a data service locally
 - See the library and CLI reference
-- [Get support](support.md)
+- [Get support](../support.md)

mkdocs.yml

@@ -4,12 +4,16 @@ site_url: https://twined.octue.com
 nav:
   - Overview: index.md
   - installation.md
-  - Setting up infrastructure: infrastructure.md
-  - Creating a service: creating.md
+  - Using services:
+      - using_services/getting_started.md
+  - Creating services:
+      - creating_services/getting_started.md
+  - Managing infrastructure:
+      - managing_infrastructure/getting_started.md
+  - glossary.md
   - license.md
   - version_history.md
   - support.md
-  - glossary.md
 
 theme:
   name: material