Improve module docs and README links

ubyndr · ubyndr · commit 19b71341cfcd · 2025-12-02T13:25:00.000Z
diff --git a/README.md b/README.md
@@ -47,9 +47,10 @@ See the [Quick Start guide](docs/quickstart.rst) for a step-by-step workflow.
 
 Full documentation (quick start, recipes, developer guide, and API reference) lives under `docs/` and is published from the `gh-pages` branch:
 
-- [Quick Start](docs/quickstart.rst)
-- [Guides](docs/guides/index.rst)
-- [API reference](docs/pandasaurus/index.rst)
+- [Hosted documentation](https://incatools.github.io/PandaSaurus/)
+- [Quick Start (source)](docs/quickstart.rst)
+- [Guides (source)](docs/guides/index.rst)
+- [API reference (source)](docs/pandasaurus/index.rst)
 
 To build docs locally:
 
diff --git a/docs/pandasaurus/graph/graph_generator.rst b/docs/pandasaurus/graph/graph_generator.rst
@@ -1,10 +1,17 @@
 Graph Generator
-==================
+===============
 
-Documentation
--------------
+``GraphGenerator`` turns enrichment results into rdflib graphs and applies transitive reduction so you can visualize clean hierarchies.
+
+Use it when:
+
+* You need a graph representation of the enriched DataFrame (for plotting or exporting).
+* You want to remove redundant edges before exporting to visualization tools.
+
+Class Reference
+---------------
 
 .. currentmodule:: pandasaurus.graph.graph_generator
 
 .. autoclass:: GraphGenerator
-   :members:
+   :members:
diff --git a/docs/pandasaurus/graph/index.rst b/docs/pandasaurus/graph/index.rst
@@ -1,6 +1,8 @@
 Graph Module
 =======================
 
+Utilities for turning enrichment results into graphs and reducing redundancy before visualization.
+
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
diff --git a/docs/pandasaurus/slim_manager.rst b/docs/pandasaurus/slim_manager.rst
@@ -1,10 +1,17 @@
 Slim Manager
-==================
+============
 
-Documentation
--------------
+Use :class:`pandasaurus.slim_manager.SlimManager` to explore ontology slims (subset tags) and retrieve the CURIEs they reference.
+
+Typical scenarios:
+
+* Enumerate slims available in an ontology via :meth:`~SlimManager.get_slim_list`.
+* Expand your seed list with all members of one or more slims via :meth:`~SlimManager.get_slim_members`.
+
+Class Reference
+---------------
 
 .. currentmodule:: pandasaurus.slim_manager
 
 .. autoclass:: SlimManager
-   :members:
+   :members:
