diff --git a/docs/api.rst b/docs/api.rst
index 437dda37f..1e0da6b36 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -6,9 +6,25 @@
 libpysal API reference
 ======================
 
+Spatial Graph
+-------------
+
+Modern implementation of spatial graphs encoding spatial weights matrices.
+
+.. autosummary::
+   :toctree: generated/
+
+   libpysal.graph.Graph
+   libpysal.graph.GraphSummary
+   libpysal.graph.read_parquet
+   libpysal.graph.read_gal
+   libpysal.graph.read_gwt
+
 Spatial Weights
 ---------------
 
+Legacy implementation of spatial weights matrices.
+
 .. autosummary::
    :toctree: generated/
 
@@ -251,19 +267,3 @@ examples
    libpysal.examples.get_path
 
 
-Experimental
-------------
-
-Experimental modules with unstable API.
-
-graph
------
-
-.. autosummary::
-   :toctree: generated/
-
-   libpysal.graph.Graph
-   libpysal.graph.GraphSummary
-   libpysal.graph.read_parquet
-   libpysal.graph.read_gal
-   libpysal.graph.read_gwt