astrodbtoolkit · dr-rodriguez · Feb 3, 2026 · Feb 3, 2026 · Feb 3, 2026 · Feb 3, 2026
diff --git a/docs/conf.py b/docs/conf.py
@@ -36,7 +36,7 @@
 
 # Get markdown files for the template schema from astrodb-template-db/ repository
 
-template_schema_path = os.path.join("pages", "template_schema", "astrodb-template-db")
+template_schema_path = os.path.join("pages", "getting_started", "template_schema", "astrodb-template-db")
 if os.path.exists(template_schema_path):
     template_repo = Repo(template_schema_path)
     try:

diff --git a/docs/index.rst b/docs/index.rst
@@ -14,24 +14,16 @@ a package built on `SQLAlchemy <https://www.sqlalchemy.org/>`_.
 User Guide
 ==================================
 
+
 .. toctree::
    :glob:
-   :maxdepth: 1
-
-   Overview of the AstroDB Toolkit <pages/overview/organization>
-   Installing astrodb-utils <pages/installation>
-   pages/loading/index
-   pages/querying_existing_db/index
-   pages/ingesting/index
-   pages/modifying/index
-   pages/make_new_db/index
-   pages/template_repo/index
-   pages/template_schema/template_schema
-   pages/making_private_version
-   pages/ingesting/spectra/converting_spectra/converting_spectra
-   pages/getting_help/index
-   Developer documentation <pages/dev_docs/developer_installation>
-   API documentation <pages/api>
+   :maxdepth: 2
+
+   pages/getting_started/index
+   pages/db_management/index
+   pages/db_access/index
+   pages/utilities/index
+   pages/reference/index
 
 
 License & attribution

diff --git a/docs/pages/db_access/index.rst b/docs/pages/db_access/index.rst
@@ -0,0 +1,10 @@
+Working with databases
+======================
+
+.. toctree::
+    :glob:
+    :maxdepth: 2
+
+    loading/index
+    querying_existing_db/index
+    ingesting/getting_started_ingesting
diff --git a/docs/pages/ingesting/index.rst → ...s/ingesting/getting_started_ingesting.rst b/docs/pages/ingesting/index.rst → ...s/ingesting/getting_started_ingesting.rst
@@ -8,12 +8,10 @@ Ingesting and Modifying Data
 
     ingest_scripts/index
     ingesting_publications
-    spectra/*
-
 
 
 .. note::
-    If you want to add or modify the tables or columns (rather than just add/modify database contents), see :doc:`/pages/modifying/index`.
+    If you want to add or modify the tables or columns (rather than just add/modify database contents), see :doc:`/pages/db_management/modifying/index`.
 
 
 API Documentation

diff --git a/.../pages/ingesting/ingest_scripts/index.rst → ...access/ingesting/ingest_scripts/index.rst b/.../pages/ingesting/ingest_scripts/index.rst → ...access/ingesting/ingest_scripts/index.rst
diff --git a/...esting/ingest_scripts/writing_scripts.rst → ...esting/ingest_scripts/writing_scripts.rst b/...esting/ingest_scripts/writing_scripts.rst → ...esting/ingest_scripts/writing_scripts.rst
diff --git a/...ages/ingesting/ingesting_publications.rst → ...cess/ingesting/ingesting_publications.rst b/...ages/ingesting/ingesting_publications.rst → ...cess/ingesting/ingesting_publications.rst
@@ -30,6 +30,7 @@ Ingesting publications
 Below is an example script for ingesting the discovery publication for Rojas et al. 2012 into the SIMPLE Archive
 
 .. code-block:: python
+
     from astrodb_utils.publications import ingest_publication, find_publication
     from astrodb_utils.loaders import read_db_from_file
 
@@ -57,7 +58,7 @@ Below is an example script for ingesting the discovery publication for Rojas et
 
 .. seealso::
 
-  :doc:`../template_schema/lookup_tables/publications`
+  :doc:`/pages/getting_started/template_schema/lookup_tables/publications`
       Documentation on the Publications table
 
   :py:mod:`find publication <astrodb_utils.publications.find_publication>` function

diff --git a/docs/pages/loading/command_line.rst → .../pages/db_access/loading/command_line.rst b/docs/pages/loading/command_line.rst → .../pages/db_access/loading/command_line.rst
diff --git a/docs/pages/loading/index.rst → docs/pages/db_access/loading/index.rst b/docs/pages/loading/index.rst → docs/pages/db_access/loading/index.rst
diff --git a/docs/pages/querying_existing_db/index.rst → .../db_access/querying_existing_db/index.rst b/docs/pages/querying_existing_db/index.rst → .../db_access/querying_existing_db/index.rst
@@ -1,5 +1,5 @@
-Querying
-========
+Querying the database
+=====================
 
 Create the Database
 ------------------------

diff --git a/docs/pages/db_management/index.rst b/docs/pages/db_management/index.rst
@@ -0,0 +1,9 @@
+Creating a New Database
+========================
+
+.. toctree::
+    :maxdepth: 2
+
+    make_new_db/index
+    modifying/index
+    making_private_version
diff --git a/docs/pages/make_new_db/create_database.rst → ...anagement/make_new_db/create_database.rst b/docs/pages/make_new_db/create_database.rst → ...anagement/make_new_db/create_database.rst
diff --git a/docs/pages/make_new_db/index.rst → ...pages/db_management/make_new_db/index.rst b/docs/pages/make_new_db/index.rst → ...pages/db_management/make_new_db/index.rst
@@ -3,11 +3,8 @@ Making a New Database
 
 .. toctree::
    :glob:
-   :maxdepth: 1
+   :maxdepth: 2
 
    new_repo
    create_database
    ingest_data
-
-
-
diff --git a/docs/pages/make_new_db/ingest_data.rst → ...db_management/make_new_db/ingest_data.rst b/docs/pages/make_new_db/ingest_data.rst → ...db_management/make_new_db/ingest_data.rst
diff --git a/docs/pages/make_new_db/new_repo.rst → ...es/db_management/make_new_db/new_repo.rst b/docs/pages/make_new_db/new_repo.rst → ...es/db_management/make_new_db/new_repo.rst
diff --git a/docs/pages/making_private_version.rst → .../db_management/making_private_version.rst b/docs/pages/making_private_version.rst → .../db_management/making_private_version.rst
diff --git a/docs/pages/modifying/index.rst → docs/pages/db_management/modifying/index.rst b/docs/pages/modifying/index.rst → docs/pages/db_management/modifying/index.rst
diff --git a/docs/pages/modifying/new_columns.rst → ...s/db_management/modifying/new_columns.rst b/docs/pages/modifying/new_columns.rst → ...s/db_management/modifying/new_columns.rst
diff --git a/docs/pages/modifying/new_tables.rst → ...es/db_management/modifying/new_tables.rst b/docs/pages/modifying/new_tables.rst → ...es/db_management/modifying/new_tables.rst
diff --git a/docs/pages/modifying/yaml.rst → docs/pages/db_management/modifying/yaml.rst b/docs/pages/modifying/yaml.rst → docs/pages/db_management/modifying/yaml.rst
diff --git a/docs/pages/getting_started/index.rst b/docs/pages/getting_started/index.rst
@@ -0,0 +1,10 @@
+Getting Started
+===========================
+
+.. toctree::
+    :maxdepth: 2
+
+    Overview of the AstroDB Toolkit <organization>
+    Installing astrodb-utils <installation>
+    template_repo/index
+    template_schema/template_schema
diff --git a/docs/pages/installation.rst → docs/pages/getting_started/installation.rst b/docs/pages/installation.rst → docs/pages/getting_started/installation.rst
diff --git a/docs/pages/overview/organization.rst → docs/pages/getting_started/organization.rst b/docs/pages/overview/organization.rst → docs/pages/getting_started/organization.rst
diff --git a/docs/pages/overview/repo_organization.png → ...ges/getting_started/repo_organization.png b/docs/pages/overview/repo_organization.png → ...ges/getting_started/repo_organization.png
diff --git a/docs/pages/template_repo/index.rst → ...s/getting_started/template_repo/index.rst b/docs/pages/template_repo/index.rst → ...s/getting_started/template_repo/index.rst
diff --git a/docs/pages/template_repo/workflows.rst → ...tting_started/template_repo/workflows.rst b/docs/pages/template_repo/workflows.rst → ...tting_started/template_repo/workflows.rst
diff --git a/...plate_schema/data_tables/associations.rst → ...plate_schema/data_tables/associations.rst b/...plate_schema/data_tables/associations.rst → ...plate_schema/data_tables/associations.rst
diff --git a/...a/data_tables/companion_relationships.rst → ...a/data_tables/companion_relationships.rst b/...a/data_tables/companion_relationships.rst → ...a/data_tables/companion_relationships.rst
diff --git a/...chema/data_tables/companionparameters.rst → ...chema/data_tables/companionparameters.rst b/...chema/data_tables/companionparameters.rst → ...chema/data_tables/companionparameters.rst
diff --git a/...ges/template_schema/data_tables/index.rst → ...ted/template_schema/data_tables/index.rst b/...ges/template_schema/data_tables/index.rst → ...ted/template_schema/data_tables/index.rst
diff --git a/..._schema/data_tables/modeledparameters.rst → ..._schema/data_tables/modeledparameters.rst b/..._schema/data_tables/modeledparameters.rst → ..._schema/data_tables/modeledparameters.rst
diff --git a/...emplate_schema/data_tables/parallaxes.rst → ...emplate_schema/data_tables/parallaxes.rst b/...emplate_schema/data_tables/parallaxes.rst → ...emplate_schema/data_tables/parallaxes.rst
diff --git a/...emplate_schema/data_tables/photometry.rst → ...emplate_schema/data_tables/photometry.rst b/...emplate_schema/data_tables/photometry.rst → ...emplate_schema/data_tables/photometry.rst
diff --git a/...late_schema/data_tables/propermotions.rst → ...late_schema/data_tables/propermotions.rst b/...late_schema/data_tables/propermotions.rst → ...late_schema/data_tables/propermotions.rst
diff --git a/...e_schema/data_tables/radialvelocities.rst → ...e_schema/data_tables/radialvelocities.rst b/...e_schema/data_tables/radialvelocities.rst → ...e_schema/data_tables/radialvelocities.rst
diff --git a/...hema/data_tables/rotationalparameters.rst → ...hema/data_tables/rotationalparameters.rst b/...hema/data_tables/rotationalparameters.rst → ...hema/data_tables/rotationalparameters.rst
diff --git a/...mplate_schema/data_tables/sourcetypes.rst → ...mplate_schema/data_tables/sourcetypes.rst b/...mplate_schema/data_tables/sourcetypes.rst → ...mplate_schema/data_tables/sourcetypes.rst
diff --git a/...s/template_schema/data_tables/spectra.rst → ...d/template_schema/data_tables/spectra.rst b/...s/template_schema/data_tables/spectra.rst → ...d/template_schema/data_tables/spectra.rst
diff --git a/..._schema/lookup_tables/associationlist.rst → ..._schema/lookup_tables/associationlist.rst b/..._schema/lookup_tables/associationlist.rst → ..._schema/lookup_tables/associationlist.rst
diff --git a/...te_schema/lookup_tables/companionlist.rst → ...te_schema/lookup_tables/companionlist.rst b/...te_schema/lookup_tables/companionlist.rst → ...te_schema/lookup_tables/companionlist.rst
diff --git a/...s/template_schema/lookup_tables/index.rst → ...d/template_schema/lookup_tables/index.rst b/...s/template_schema/lookup_tables/index.rst → ...d/template_schema/lookup_tables/index.rst
diff --git a/...late_schema/lookup_tables/instruments.rst → ...late_schema/lookup_tables/instruments.rst b/...late_schema/lookup_tables/instruments.rst → ...late_schema/lookup_tables/instruments.rst
diff --git a/...te_schema/lookup_tables/parameterlist.rst → ...te_schema/lookup_tables/parameterlist.rst b/...te_schema/lookup_tables/parameterlist.rst → ...te_schema/lookup_tables/parameterlist.rst
diff --git a/...chema/lookup_tables/photometryfilters.rst → ...chema/lookup_tables/photometryfilters.rst b/...chema/lookup_tables/photometryfilters.rst → ...chema/lookup_tables/photometryfilters.rst
diff --git a/...ate_schema/lookup_tables/publications.rst → ...ate_schema/lookup_tables/publications.rst b/...ate_schema/lookup_tables/publications.rst → ...ate_schema/lookup_tables/publications.rst
diff --git a/...plate_schema/lookup_tables/regimelist.rst → ...plate_schema/lookup_tables/regimelist.rst b/...plate_schema/lookup_tables/regimelist.rst → ...plate_schema/lookup_tables/regimelist.rst
diff --git a/...e_schema/lookup_tables/sourcetypelist.rst → ...e_schema/lookup_tables/sourcetypelist.rst b/...e_schema/lookup_tables/sourcetypelist.rst → ...e_schema/lookup_tables/sourcetypelist.rst
diff --git a/...plate_schema/lookup_tables/telescopes.rst → ...plate_schema/lookup_tables/telescopes.rst b/...plate_schema/lookup_tables/telescopes.rst → ...plate_schema/lookup_tables/telescopes.rst
diff --git a/...ges/template_schema/main_tables/index.rst → ...ted/template_schema/main_tables/index.rst b/...ges/template_schema/main_tables/index.rst → ...ted/template_schema/main_tables/index.rst
diff --git a/...ges/template_schema/main_tables/names.rst → ...ted/template_schema/main_tables/names.rst b/...ges/template_schema/main_tables/names.rst → ...ted/template_schema/main_tables/names.rst
diff --git a/...s/template_schema/main_tables/sources.rst → ...d/template_schema/main_tables/sources.rst b/...s/template_schema/main_tables/sources.rst → ...d/template_schema/main_tables/sources.rst
diff --git a/.../template_schema/main_tables/versions.rst → .../template_schema/main_tables/versions.rst b/.../template_schema/main_tables/versions.rst → .../template_schema/main_tables/versions.rst
diff --git a/...pages/template_schema/template_schema.rst → ...arted/template_schema/template_schema.rst b/...pages/template_schema/template_schema.rst → ...arted/template_schema/template_schema.rst
diff --git a/docs/pages/api.rst → docs/pages/reference/api.rst b/docs/pages/api.rst → docs/pages/reference/api.rst
@@ -53,17 +53,11 @@ Publications
     :members:
     :undoc-members:
     :show-inheritance:
+
 Instruments
 ------------
 
 .. automodule:: astrodb_utils.instruments
     :members:
     :undoc-members:
     :show-inheritance:
-
-Loaders
-------------
-.. automodule:: astrodb_utils.loaders
-    :members:
-    :undoc-members:
-    :show-inheritance:
diff --git a/...pages/dev_docs/developer_installation.rst → ...ages/reference/developer_installation.rst b/...pages/dev_docs/developer_installation.rst → ...ages/reference/developer_installation.rst
diff --git a/docs/pages/dev_docs/documentation.rst → docs/pages/reference/documentation.rst b/docs/pages/dev_docs/documentation.rst → docs/pages/reference/documentation.rst
@@ -16,6 +16,6 @@ To build the docs, use `sphinx-autobuild <https://pypi.org/project/sphinx-autobu
 .. code-block:: bash
 
     pip install -e ".[docs]"
-    sphinx-autobuild docs docs/_build/html --ignore=docs/pages/template_schema/astrodb-template-db/.git/
+    sphinx-autobuild docs docs/_build/html --ignore=docs/pages/getting_started/template_schema/astrodb-template-db/
 
 The docs will then be available locally at <http://127.0.0.1:8000>.
diff --git a/docs/pages/reference/index.rst b/docs/pages/reference/index.rst
@@ -0,0 +1,9 @@
+Reference Information
+=====================
+
+.. toctree::
+    :glob:
+    :maxdepth: 2
+
+    developer_installation
+    api
diff --git a/docs/pages/dev_docs/ingest_functions.rst → docs/pages/reference/ingest_functions.rst b/docs/pages/dev_docs/ingest_functions.rst → docs/pages/reference/ingest_functions.rst
diff --git a/docs/pages/getting_help/faq.rst → docs/pages/utilities/getting_help/faq.rst b/docs/pages/getting_help/faq.rst → docs/pages/utilities/getting_help/faq.rst
diff --git a/docs/pages/getting_help/index.rst → docs/pages/utilities/getting_help/index.rst b/docs/pages/getting_help/index.rst → docs/pages/utilities/getting_help/index.rst
diff --git a/docs/pages/utilities/index.rst b/docs/pages/utilities/index.rst
@@ -0,0 +1,9 @@
+Utilities and support
+=====================
+
+.. toctree::
+    :glob:
+    :maxdepth: 2
+
+    spectra/index
+    getting_help/index
diff --git a/...converting_spectra/converting_spectra.rst → ...converting_spectra/converting_spectra.rst b/...converting_spectra/converting_spectra.rst → ...converting_spectra/converting_spectra.rst
diff --git a/...nverting_spectra/fits_header_modify.ipynb → ...nverting_spectra/fits_header_modify.ipynb b/...nverting_spectra/fits_header_modify.ipynb → ...nverting_spectra/fits_header_modify.ipynb
diff --git a/...verting_spectra/fits_header_scratch.ipynb → ...verting_spectra/fits_header_scratch.ipynb b/...verting_spectra/fits_header_scratch.ipynb → ...verting_spectra/fits_header_scratch.ipynb
diff --git a/docs/pages/ingesting/spectra/index.rst → docs/pages/utilities/spectra/index.rst b/docs/pages/ingesting/spectra/index.rst → docs/pages/utilities/spectra/index.rst
@@ -17,9 +17,10 @@ to check if a spectrum is loadable by `astropy.specutils` and plottable.
 The `matplotlib` package needs to be installed to display the spectrum using `show_plot=True`.
 
 .. code-block:: python
-   from astrodb_utils.spectra import check_spectrum_plottable
-   file = <path to file>
-   plottable = check_spectrum_plottable(file, show_plot=True)
-   print plottable
+
+    from astrodb_utils.spectra import check_spectrum_plottable
+    file = <path to file>
+    plottable = check_spectrum_plottable(file, show_plot=True)
+    print plottable
 
-   > True
+    > True