FRBs · SunilSimha · Apr 21, 2026 · Apr 20, 2026 · Apr 20, 2026 · Apr 20, 2026
diff --git a/.github/workflows/ci_tests.yml b/.github/workflows/ci_tests.yml
@@ -3,7 +3,7 @@ name: CI Tests
 on:
   push:
     branches:
-    - master
+    - main
   pull_request:
 
 env:

diff --git a/docs/api/analysis.kcwi.rst b/docs/api/analysis.kcwi.rst
@@ -0,0 +1,13 @@
+frb.analysis.kcwi
+=================
+
+.. automodule:: frb.analysis.kcwi
+
+.. note::
+   Optional dependencies: ``pyregion`` and ``spectral-cube`` are required
+   for full KCWI functionality.
+
+.. note::
+   Member-level API expansion is intentionally omitted here because several
+   upstream function docstrings are not valid reStructuredText and trigger
+   docutils parse errors during ``make html``.
diff --git a/docs/api/analysis.rst b/docs/api/analysis.rst
@@ -0,0 +1,15 @@
+frb.analysis
+============
+
+.. automodule:: frb.analysis
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+.. toctree::
+   :maxdepth: 1
+
+   analysis.kcwi
diff --git a/docs/api/associate.frbassociate.rst b/docs/api/associate.frbassociate.rst
@@ -0,0 +1,8 @@
+frb.associate.frbassociate
+==========================
+
+.. automodule:: frb.associate.frbassociate
+
+.. note::
+   Member-level API expansion is intentionally omitted here to keep
+   ``make html`` stable with current upstream docstring formatting.
diff --git a/docs/api/associate.frbs.rst b/docs/api/associate.frbs.rst
@@ -0,0 +1,7 @@
+frb.associate.frbs
+==================
+
+.. automodule:: frb.associate.frbs
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/associate.gen_pox_table.rst b/docs/api/associate.gen_pox_table.rst
@@ -0,0 +1,7 @@
+frb.associate.gen_pox_table
+===========================
+
+.. automodule:: frb.associate.gen_pox_table
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/associate.rst b/docs/api/associate.rst
@@ -9,18 +9,9 @@ frb.associate - FRB-Galaxy Association
 Submodules
 ----------
 
-frb.associate.frbassociate - FRBAssociate Class
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. toctree::
+   :maxdepth: 1
 
-.. automodule:: frb.associate.frbassociate
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-frb.associate.frbs - FRB Association Data
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: frb.associate.frbs
-   :members:
-   :undoc-members:
-   :show-inheritance:
+   associate.frbassociate
+   associate.frbs
+   associate.gen_pox_table
diff --git a/docs/api/builds.build_fg.rst b/docs/api/builds.build_fg.rst
@@ -0,0 +1,7 @@
+frb.builds.build_fg
+===================
+
+.. automodule:: frb.builds.build_fg
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/builds.build_frbs.rst b/docs/api/builds.build_frbs.rst
@@ -0,0 +1,7 @@
+frb.builds.build_frbs
+=====================
+
+.. automodule:: frb.builds.build_frbs
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/builds.build_hosts.rst b/docs/api/builds.build_hosts.rst
@@ -0,0 +1,7 @@
+frb.builds.build_hosts
+======================
+
+.. automodule:: frb.builds.build_hosts
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/builds.build_path.rst b/docs/api/builds.build_path.rst
@@ -0,0 +1,7 @@
+frb.builds.build_path
+=====================
+
+.. automodule:: frb.builds.build_path
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/builds.build_specdb.rst b/docs/api/builds.build_specdb.rst
@@ -0,0 +1,10 @@
+frb.builds.build_specdb
+=======================
+
+.. automodule:: frb.builds.build_specdb
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. note::
+   Optional dependency: ``specdb`` is required to build spectroscopic databases.
diff --git a/docs/api/builds.old_build_frbs.rst b/docs/api/builds.old_build_frbs.rst
@@ -0,0 +1,8 @@
+frb.builds.old_build_frbs
+=========================
+
+.. automodule:: frb.builds.old_build_frbs
+
+.. note::
+   Member-level API expansion is intentionally omitted here to avoid
+   docstring parsing warnings in the current codebase.
diff --git a/docs/api/builds.old_build_hosts.rst b/docs/api/builds.old_build_hosts.rst
@@ -0,0 +1,7 @@
+frb.builds.old_build_hosts
+==========================
+
+.. automodule:: frb.builds.old_build_hosts
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/builds.rst b/docs/api/builds.rst
@@ -0,0 +1,22 @@
+frb.builds
+==========
+
+.. automodule:: frb.builds
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+.. toctree::
+   :maxdepth: 1
+
+   builds.build_fg
+   builds.build_frbs
+   builds.build_hosts
+   builds.build_path
+   builds.build_specdb
+   builds.utils
+   builds.old_build_frbs
+   builds.old_build_hosts
diff --git a/docs/api/builds.utils.rst b/docs/api/builds.utils.rst
@@ -0,0 +1,7 @@
+frb.builds.utils
+================
+
+.. automodule:: frb.builds.utils
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/defs.rst b/docs/api/defs.rst
@@ -0,0 +1,7 @@
+frb.defs
+========
+
+.. automodule:: frb.defs
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/dm.cosmic.rst b/docs/api/dm.cosmic.rst
@@ -0,0 +1,7 @@
+frb.dm.cosmic
+=============
+
+.. automodule:: frb.dm.cosmic
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/dm.dm_ism_healpix_map.rst b/docs/api/dm.dm_ism_healpix_map.rst
@@ -0,0 +1,7 @@
+frb.dm.dm_ism_healpix_map
+=========================
+
+.. automodule:: frb.dm.dm_ism_healpix_map
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/dm.host.rst b/docs/api/dm.host.rst
@@ -0,0 +1,7 @@
+frb.dm.host
+===========
+
+.. automodule:: frb.dm.host
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/dm.igm.rst b/docs/api/dm.igm.rst
@@ -0,0 +1,8 @@
+frb.dm.igm
+==========
+
+.. automodule:: frb.dm.igm
+
+.. note::
+   Member-level API expansion is intentionally omitted here to avoid
+   docstring parsing warnings from legacy formatting.
diff --git a/docs/api/dm.mcmc.rst b/docs/api/dm.mcmc.rst
@@ -0,0 +1,7 @@
+frb.dm.mcmc
+===========
+
+.. automodule:: frb.dm.mcmc
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/dm.prob_dmz.rst b/docs/api/dm.prob_dmz.rst
@@ -0,0 +1,7 @@
+frb.dm.prob_dmz
+===============
+
+.. automodule:: frb.dm.prob_dmz
+   :members:
+   :undoc-members:
+   :show-inheritance:
-Original file line number
+Diff line change
@@ Expand Up / @@ -3,7 +3,7 @@ name: CI Tests @@
     on:
       push:
         branches:
-        - master
+        - main
       pull_request:
     env:
@@ Expand Down @@