sunpy · nabobalis · Sep 14, 2022 · Sep 14, 2022 · Sep 14, 2022
diff --git a/docs/code_ref/fermi.rst b/docs/code_ref/fermi.rst
@@ -1 +1,5 @@
+=====
+Fermi
+=====
+
 .. automodapi:: sunkit_instruments.fermi
diff --git a/docs/code_ref/goes_xrs.rst b/docs/code_ref/goes_xrs.rst
@@ -1 +1,4 @@
+========
+GOES XRS
+========
 .. automodapi:: sunkit_instruments.goes_xrs
diff --git a/docs/code_ref/index.rst b/docs/code_ref/index.rst
@@ -7,7 +7,6 @@ API Reference
 .. toctree::
    :maxdepth: 2
 
-   sunkit_instruments
    fermi
    goes_xrs
    iris

diff --git a/docs/code_ref/iris.rst b/docs/code_ref/iris.rst
@@ -1 +1,5 @@
+====
+IRIS
+====
+
 .. automodapi:: sunkit_instruments.iris
diff --git a/docs/code_ref/lyra.rst b/docs/code_ref/lyra.rst
@@ -1 +1,5 @@
+====
+LYRA
+====
+
 .. automodapi:: sunkit_instruments.lyra
diff --git a/docs/code_ref/rhessi.rst b/docs/code_ref/rhessi.rst
@@ -1 +1,5 @@
+======
+RHESSI
+======
+
 .. automodapi:: sunkit_instruments.rhessi
diff --git a/docs/code_ref/sunkit_instruments.rst b/docs/code_ref/sunkit_instruments.rst
diff --git a/docs/code_ref/suvi.rst b/docs/code_ref/suvi.rst
@@ -1,4 +1,8 @@
-This package provides helper routines for the SUVI (Solar UltraViolet Imager) instrument on the GOES-R series of satellites.
+====
+SUVI
+====
+
+Helper routines for the Solar UltraViolet Imager (SUVI) instrument on the GOES-R series of satellites.
 
 .. note::
 

diff --git a/docs/index.rst b/docs/index.rst
@@ -1,12 +1,21 @@
-================================
-sunkit-instruments Documentation
-================================
+==================
+sunkit-instruments
+==================
 
-This is the documentation for sunkit-instruments.
+A package for instrument-specific data structures and processing in the SunPy ecosystem.
+
+``sunkit-instruments`` is organised into sub-modules for each instrument:
 
 .. toctree::
    :maxdepth: 2
 
    code_ref/index
    generated/gallery/index
    whatsnew/index
+
+
+Note that the code in this package is **not** maintained by or neccesarily contributed to by instrument teams.
+Some instruments have individual packages for analysis in Python, including:
+
+- `aiapy <https://aiapy.readthedocs.io/en/stable/>`__
+- `eispac <https://eispac.readthedocs.io/en/latest/>`__