From 8793b1024c8633c02d59af79ec255cf0276c8f65 Mon Sep 17 00:00:00 2001
From: Matthew Humphreys <mvdh7@users.noreply.github.com>
Date: Fri, 10 Jan 2025 16:50:39 +0100
Subject: [PATCH] Update overview

---
 docs/index.md | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 471e5ed..b91050e 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,15 +20,21 @@ Install from the [conda-forge channel](https://anaconda.org/conda-forge/pyco2sys
 
     conda install conda-forge::PyCO2SYS
 
-## Basic use
+## How to use PyCO2SYS
 
-See:
+Start with the
+
+  * [Quick-start guide](quick.md)
+
+before moving on to
 
-  * [Quick-start guide](quick.md), 
   * [Arguments and results](detail.md),
-  * [Adjust conditions](adjust.md),
-  * [Uncertainty propagation](uncertainty.md) and
-  * [Advanced results access](results.md)
+  * [Adjust conditions](adjust.md) and
+  * [Uncertainty propagation](uncertainty.md).
+
+If you're really interested, also look at
+
+  * [Advanced results access](results.md).
 
 If you're already familiar with PyCO2SYS v1, then