docs: rework high level features and api page

docs/source/api/index.rst

@@ -3,16 +3,12 @@ API reference
 =============
 
 .. automodule:: finam
+   :noindex:
 
 .. raw:: latex
 
     \clearpage
 
-.. toctree::
-   :hidden:
-
-   self
-
 .. toctree::
    :hidden:
    :caption: Subpackages

src/finam/__init__.py

 """
 The FINAM model coupling framework.
 
-Subpackages
-===========
+.. toctree::
+   :hidden:
 
-.. autosummary::
-
-    adapters
-    data
-    modules
-    sdk
-    tools
-    interfaces
-    schedule
+   self
 
 Schedule
 ========
 
-.. currentmodule:: finam.schedule
-
 .. autosummary::
+   :toctree: generated
+   :caption: Schedule
 
     Composition
 
-Interfaces
-==========
-
-.. currentmodule:: finam.interfaces
-
-.. autosummary::
-
-    ComponentStatus
-    FinamLogError
-    FinamMetaDataError
-    FinamNoDataError
-    FinamStatusError
-    FinamTimeError
-    Loggable
-    NoBranchAdapter
-
 Software development kit
 ========================
 
-.. currentmodule:: finam.sdk
-
 .. autosummary::
+   :toctree: generated
+   :caption: Software development kit
 
     Adapter
     CallbackInput
@@ -57,9 +33,9 @@ Software development kit
 Grids
 =====
 
-.. currentmodule:: finam.data
-
 .. autosummary::
+   :toctree: generated
+   :caption: Grids
 
     EsriGrid
     NoGrid
@@ -71,9 +47,9 @@ Grids
 Grid tools
 ==========
 
-.. currentmodule:: finam.data
-
 .. autosummary::
+   :toctree: generated
+   :caption: Grid tools
 
     CellType
     Location
@@ -81,13 +57,43 @@ Grid tools
 Data tools
 ==========
 
-.. currentmodule:: finam.data
-
 .. autosummary::
+   :toctree: generated
+   :caption: Data tools
 
     UNITS
     FinamDataError
     Info
+
+Interfaces
+==========
+
+.. autosummary::
+   :toctree: generated
+   :caption: Interfaces
+
+    ComponentStatus
+    FinamLogError
+    FinamMetaDataError
+    FinamNoDataError
+    FinamStatusError
+    FinamTimeError
+    Loggable
+    NoBranchAdapter
+
+Subpackages
+===========
+
+.. autosummary::
+
+    adapters
+    data
+    modules
+    sdk
+    tools
+    interfaces
+    schedule
+
 """
 from . import adapters, data, interfaces, modules, schedule, sdk, tools
 from .data.grid_spec import (