From f8f015f5cf6dc3d79a90a672760a6830caec397c Mon Sep 17 00:00:00 2001 From: David Rodriguez Date: Tue, 3 Feb 2026 16:17:00 -0500 Subject: [PATCH 1/6] Reorganizing docs --- README.md | 14 ++++++++++++++ docs/index.rst | 18 +++++++++++++++++- 2 files changed, 31 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ebe8b59..18f4df1 100644 --- a/README.md +++ b/README.md @@ -9,3 +9,17 @@ The AstroDB Toolkit provides a set of tools to help astronomers work with and cr The `astrodb_utils` package provides a set of functions to query and ingest data into databases built with the `astrodb-template-db` schema. [Documentation for the Toolkit](https://astrodb-utils.readthedocs.io/en/stable/) + +--- + +Manual build of the documentation: +```bash +pip install -e ".[docs]" +sphinx-autobuild docs docs/_build/html +``` + +If you get an error with Pandoc, you can install it with: +```bash +conda install -c conda-forge pandoc +``` +See https://pandoc.org/installing.html for other options diff --git a/docs/index.rst b/docs/index.rst index 4ba93df..ff1152a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -14,20 +14,36 @@ a package built on `SQLAlchemy `_. User Guide ================================== + .. toctree:: - :glob: + :caption: Getting started :maxdepth: 1 Overview of the AstroDB Toolkit Installing astrodb-utils + +.. toctree:: + :caption: Working with databases + :maxdepth: 1 + pages/loading/index pages/querying_existing_db/index pages/ingesting/getting_started_ingesting + +.. toctree:: + :caption: Schema & customization + :maxdepth: 1 + pages/modifying/index pages/make_new_db/index pages/template_repo/index pages/template_schema/template_schema pages/making_private_version + +.. toctree:: + :caption: Utilities & support + :maxdepth: 1 + pages/ingesting/spectra/converting_spectra/converting_spectra pages/getting_help/index Developer documentation From c09dbf65b8ff0ef15ce4085b0b3b48f29aaa364b Mon Sep 17 00:00:00 2001 From: David Rodriguez Date: Tue, 3 Feb 2026 16:20:59 -0500 Subject: [PATCH 2/6] more edits --- README.md | 14 -------------- docs/index.rst | 20 ++++++++++---------- 2 files changed, 10 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 18f4df1..ebe8b59 100644 --- a/README.md +++ b/README.md @@ -9,17 +9,3 @@ The AstroDB Toolkit provides a set of tools to help astronomers work with and cr The `astrodb_utils` package provides a set of functions to query and ingest data into databases built with the `astrodb-template-db` schema. [Documentation for the Toolkit](https://astrodb-utils.readthedocs.io/en/stable/) - ---- - -Manual build of the documentation: -```bash -pip install -e ".[docs]" -sphinx-autobuild docs docs/_build/html -``` - -If you get an error with Pandoc, you can install it with: -```bash -conda install -c conda-forge pandoc -``` -See https://pandoc.org/installing.html for other options diff --git a/docs/index.rst b/docs/index.rst index ff1152a..95abe9d 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -21,24 +21,24 @@ User Guide Overview of the AstroDB Toolkit Installing astrodb-utils + pages/template_repo/index + pages/template_schema/template_schema .. toctree:: - :caption: Working with databases + :caption: Creating a new database :maxdepth: 1 - pages/loading/index - pages/querying_existing_db/index - pages/ingesting/getting_started_ingesting + pages/make_new_db/index + pages/modifying/index + pages/making_private_version .. toctree:: - :caption: Schema & customization + :caption: Working with databases :maxdepth: 1 - pages/modifying/index - pages/make_new_db/index - pages/template_repo/index - pages/template_schema/template_schema - pages/making_private_version + pages/loading/index + pages/querying_existing_db/index + pages/ingesting/getting_started_ingesting .. toctree:: :caption: Utilities & support From 6c609cbb0ca0b81a7926f94cf95f0d9a8f7f7ee0 Mon Sep 17 00:00:00 2001 From: David Rodriguez Date: Tue, 3 Feb 2026 16:22:07 -0500 Subject: [PATCH 3/6] more edits --- docs/index.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/index.rst b/docs/index.rst index 95abe9d..1e0d7fc 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -46,6 +46,11 @@ User Guide pages/ingesting/spectra/converting_spectra/converting_spectra pages/getting_help/index + +.. toctree:: + :caption: Reference Information + :maxdepth: 1 + Developer documentation API documentation From 3c1b8125f6a2b08f4014d0a1024cd1a29084c29e Mon Sep 17 00:00:00 2001 From: David Rodriguez Date: Tue, 3 Feb 2026 16:51:26 -0500 Subject: [PATCH 4/6] reorganizing files --- docs/conf.py | 2 +- docs/index.rst | 45 ++++-------------- docs/pages/db_access/index.rst | 10 ++++ .../ingesting/getting_started_ingesting.rst | 0 .../ingesting/ingest_scripts.rst | 0 .../ingesting/ingesting_publications.rst | 0 .../{ => db_access}/loading/command_line.rst | 0 docs/pages/{ => db_access}/loading/index.rst | 0 .../querying_existing_db/index.rst | 0 docs/pages/db_management/index.rst | 9 ++++ .../make_new_db/create_database.rst | 0 .../{ => db_management}/make_new_db/index.rst | 5 +- .../make_new_db/ingest_data.rst | 0 .../make_new_db/new_repo.rst | 0 .../making_private_version.rst | 0 .../{ => db_management}/modifying/index.rst | 0 .../modifying/new_columns.rst | 0 .../modifying/new_tables.rst | 0 .../{ => db_management}/modifying/yaml.rst | 0 docs/pages/getting_started/index.rst | 10 ++++ .../{ => getting_started}/installation.rst | 0 .../organization.rst | 0 .../repo_organization.png | Bin .../template_repo/index.rst | 0 .../template_repo/workflows.rst | 0 .../data_tables/associations.rst | 0 .../data_tables/companion_relationships.rst | 0 .../data_tables/companionparameters.rst | 0 .../template_schema/data_tables/index.rst | 0 .../data_tables/modeledparameters.rst | 0 .../data_tables/parallaxes.rst | 0 .../data_tables/photometry.rst | 0 .../data_tables/propermotions.rst | 0 .../data_tables/radialvelocities.rst | 0 .../data_tables/rotationalparameters.rst | 0 .../data_tables/sourcetypes.rst | 0 .../template_schema/data_tables/spectra.rst | 0 .../lookup_tables/associationlist.rst | 0 .../lookup_tables/companionlist.rst | 0 .../template_schema/lookup_tables/index.rst | 0 .../lookup_tables/instruments.rst | 0 .../lookup_tables/parameterlist.rst | 0 .../lookup_tables/photometryfilters.rst | 0 .../lookup_tables/publications.rst | 0 .../lookup_tables/regimelist.rst | 0 .../lookup_tables/sourcetypelist.rst | 0 .../lookup_tables/telescopes.rst | 0 .../template_schema/main_tables/index.rst | 0 .../template_schema/main_tables/names.rst | 0 .../template_schema/main_tables/sources.rst | 0 .../template_schema/main_tables/versions.rst | 0 .../template_schema/template_schema.rst | 0 docs/pages/{ => reference}/api.rst | 0 .../developer_installation.rst | 0 .../{dev_docs => reference}/documentation.rst | 2 +- docs/pages/reference/index.rst | 9 ++++ .../ingest_functions.rst | 0 .../{ => utilities}/getting_help/faq.rst | 0 .../{ => utilities}/getting_help/index.rst | 0 docs/pages/utilities/index.rst | 9 ++++ .../converting_spectra/converting_spectra.rst | 0 .../fits_header_modify.ipynb | 0 .../fits_header_scratch.ipynb | 0 .../spectra/index.rst | 0 64 files changed, 58 insertions(+), 43 deletions(-) create mode 100644 docs/pages/db_access/index.rst rename docs/pages/{ => db_access}/ingesting/getting_started_ingesting.rst (100%) rename docs/pages/{ => db_access}/ingesting/ingest_scripts.rst (100%) rename docs/pages/{ => db_access}/ingesting/ingesting_publications.rst (100%) rename docs/pages/{ => db_access}/loading/command_line.rst (100%) rename docs/pages/{ => db_access}/loading/index.rst (100%) rename docs/pages/{ => db_access}/querying_existing_db/index.rst (100%) create mode 100644 docs/pages/db_management/index.rst rename docs/pages/{ => db_management}/make_new_db/create_database.rst (100%) rename docs/pages/{ => db_management}/make_new_db/index.rst (85%) rename docs/pages/{ => db_management}/make_new_db/ingest_data.rst (100%) rename docs/pages/{ => db_management}/make_new_db/new_repo.rst (100%) rename docs/pages/{ => db_management}/making_private_version.rst (100%) rename docs/pages/{ => db_management}/modifying/index.rst (100%) rename docs/pages/{ => db_management}/modifying/new_columns.rst (100%) rename docs/pages/{ => db_management}/modifying/new_tables.rst (100%) rename docs/pages/{ => db_management}/modifying/yaml.rst (100%) create mode 100644 docs/pages/getting_started/index.rst rename docs/pages/{ => getting_started}/installation.rst (100%) rename docs/pages/{overview => getting_started}/organization.rst (100%) rename docs/pages/{overview => getting_started}/repo_organization.png (100%) rename docs/pages/{ => getting_started}/template_repo/index.rst (100%) rename docs/pages/{ => getting_started}/template_repo/workflows.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/associations.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/companion_relationships.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/companionparameters.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/index.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/modeledparameters.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/parallaxes.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/photometry.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/propermotions.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/radialvelocities.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/rotationalparameters.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/sourcetypes.rst (100%) rename docs/pages/{ => getting_started}/template_schema/data_tables/spectra.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/associationlist.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/companionlist.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/index.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/instruments.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/parameterlist.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/photometryfilters.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/publications.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/regimelist.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/sourcetypelist.rst (100%) rename docs/pages/{ => getting_started}/template_schema/lookup_tables/telescopes.rst (100%) rename docs/pages/{ => getting_started}/template_schema/main_tables/index.rst (100%) rename docs/pages/{ => getting_started}/template_schema/main_tables/names.rst (100%) rename docs/pages/{ => getting_started}/template_schema/main_tables/sources.rst (100%) rename docs/pages/{ => getting_started}/template_schema/main_tables/versions.rst (100%) rename docs/pages/{ => getting_started}/template_schema/template_schema.rst (100%) rename docs/pages/{ => reference}/api.rst (100%) rename docs/pages/{dev_docs => reference}/developer_installation.rst (100%) rename docs/pages/{dev_docs => reference}/documentation.rst (80%) create mode 100644 docs/pages/reference/index.rst rename docs/pages/{dev_docs => reference}/ingest_functions.rst (100%) rename docs/pages/{ => utilities}/getting_help/faq.rst (100%) rename docs/pages/{ => utilities}/getting_help/index.rst (100%) create mode 100644 docs/pages/utilities/index.rst rename docs/pages/{ingesting => utilities}/spectra/converting_spectra/converting_spectra.rst (100%) rename docs/pages/{ingesting => utilities}/spectra/converting_spectra/fits_header_modify.ipynb (100%) rename docs/pages/{ingesting => utilities}/spectra/converting_spectra/fits_header_scratch.ipynb (100%) rename docs/pages/{ingesting => utilities}/spectra/index.rst (100%) diff --git a/docs/conf.py b/docs/conf.py index 2cca1be..6f9c3e8 100644 --- 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 index 1e0d7fc..8605b32 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -16,43 +16,14 @@ User Guide .. toctree:: - :caption: Getting started - :maxdepth: 1 - - Overview of the AstroDB Toolkit - Installing astrodb-utils - pages/template_repo/index - pages/template_schema/template_schema - -.. toctree:: - :caption: Creating a new database - :maxdepth: 1 - - pages/make_new_db/index - pages/modifying/index - pages/making_private_version - -.. toctree:: - :caption: Working with databases - :maxdepth: 1 - - pages/loading/index - pages/querying_existing_db/index - pages/ingesting/getting_started_ingesting - -.. toctree:: - :caption: Utilities & support - :maxdepth: 1 - - pages/ingesting/spectra/converting_spectra/converting_spectra - pages/getting_help/index - -.. toctree:: - :caption: Reference Information - :maxdepth: 1 - - Developer documentation - API documentation + :glob: + :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 new file mode 100644 index 0000000..4be3063 --- /dev/null +++ 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/getting_started_ingesting.rst b/docs/pages/db_access/ingesting/getting_started_ingesting.rst similarity index 100% rename from docs/pages/ingesting/getting_started_ingesting.rst rename to docs/pages/db_access/ingesting/getting_started_ingesting.rst diff --git a/docs/pages/ingesting/ingest_scripts.rst b/docs/pages/db_access/ingesting/ingest_scripts.rst similarity index 100% rename from docs/pages/ingesting/ingest_scripts.rst rename to docs/pages/db_access/ingesting/ingest_scripts.rst diff --git a/docs/pages/ingesting/ingesting_publications.rst b/docs/pages/db_access/ingesting/ingesting_publications.rst similarity index 100% rename from docs/pages/ingesting/ingesting_publications.rst rename to docs/pages/db_access/ingesting/ingesting_publications.rst diff --git a/docs/pages/loading/command_line.rst b/docs/pages/db_access/loading/command_line.rst similarity index 100% rename from docs/pages/loading/command_line.rst rename to docs/pages/db_access/loading/command_line.rst diff --git a/docs/pages/loading/index.rst b/docs/pages/db_access/loading/index.rst similarity index 100% rename from docs/pages/loading/index.rst rename to docs/pages/db_access/loading/index.rst diff --git a/docs/pages/querying_existing_db/index.rst b/docs/pages/db_access/querying_existing_db/index.rst similarity index 100% rename from docs/pages/querying_existing_db/index.rst rename to docs/pages/db_access/querying_existing_db/index.rst diff --git a/docs/pages/db_management/index.rst b/docs/pages/db_management/index.rst new file mode 100644 index 0000000..2019181 --- /dev/null +++ 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 b/docs/pages/db_management/make_new_db/create_database.rst similarity index 100% rename from docs/pages/make_new_db/create_database.rst rename to docs/pages/db_management/make_new_db/create_database.rst diff --git a/docs/pages/make_new_db/index.rst b/docs/pages/db_management/make_new_db/index.rst similarity index 85% rename from docs/pages/make_new_db/index.rst rename to docs/pages/db_management/make_new_db/index.rst index a003479..c7fd2c5 100644 --- a/docs/pages/make_new_db/index.rst +++ b/docs/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 b/docs/pages/db_management/make_new_db/ingest_data.rst similarity index 100% rename from docs/pages/make_new_db/ingest_data.rst rename to docs/pages/db_management/make_new_db/ingest_data.rst diff --git a/docs/pages/make_new_db/new_repo.rst b/docs/pages/db_management/make_new_db/new_repo.rst similarity index 100% rename from docs/pages/make_new_db/new_repo.rst rename to docs/pages/db_management/make_new_db/new_repo.rst diff --git a/docs/pages/making_private_version.rst b/docs/pages/db_management/making_private_version.rst similarity index 100% rename from docs/pages/making_private_version.rst rename to docs/pages/db_management/making_private_version.rst diff --git a/docs/pages/modifying/index.rst b/docs/pages/db_management/modifying/index.rst similarity index 100% rename from docs/pages/modifying/index.rst rename to docs/pages/db_management/modifying/index.rst diff --git a/docs/pages/modifying/new_columns.rst b/docs/pages/db_management/modifying/new_columns.rst similarity index 100% rename from docs/pages/modifying/new_columns.rst rename to docs/pages/db_management/modifying/new_columns.rst diff --git a/docs/pages/modifying/new_tables.rst b/docs/pages/db_management/modifying/new_tables.rst similarity index 100% rename from docs/pages/modifying/new_tables.rst rename to docs/pages/db_management/modifying/new_tables.rst diff --git a/docs/pages/modifying/yaml.rst b/docs/pages/db_management/modifying/yaml.rst similarity index 100% rename from docs/pages/modifying/yaml.rst rename to docs/pages/db_management/modifying/yaml.rst diff --git a/docs/pages/getting_started/index.rst b/docs/pages/getting_started/index.rst new file mode 100644 index 0000000..db71530 --- /dev/null +++ b/docs/pages/getting_started/index.rst @@ -0,0 +1,10 @@ +Getting Started +=========================== + +.. toctree:: + :maxdepth: 2 + + Overview of the AstroDB Toolkit + Installing astrodb-utils + template_repo/index + template_schema/template_schema \ No newline at end of file diff --git a/docs/pages/installation.rst b/docs/pages/getting_started/installation.rst similarity index 100% rename from docs/pages/installation.rst rename to docs/pages/getting_started/installation.rst diff --git a/docs/pages/overview/organization.rst b/docs/pages/getting_started/organization.rst similarity index 100% rename from docs/pages/overview/organization.rst rename to docs/pages/getting_started/organization.rst diff --git a/docs/pages/overview/repo_organization.png b/docs/pages/getting_started/repo_organization.png similarity index 100% rename from docs/pages/overview/repo_organization.png rename to docs/pages/getting_started/repo_organization.png diff --git a/docs/pages/template_repo/index.rst b/docs/pages/getting_started/template_repo/index.rst similarity index 100% rename from docs/pages/template_repo/index.rst rename to docs/pages/getting_started/template_repo/index.rst diff --git a/docs/pages/template_repo/workflows.rst b/docs/pages/getting_started/template_repo/workflows.rst similarity index 100% rename from docs/pages/template_repo/workflows.rst rename to docs/pages/getting_started/template_repo/workflows.rst diff --git a/docs/pages/template_schema/data_tables/associations.rst b/docs/pages/getting_started/template_schema/data_tables/associations.rst similarity index 100% rename from docs/pages/template_schema/data_tables/associations.rst rename to docs/pages/getting_started/template_schema/data_tables/associations.rst diff --git a/docs/pages/template_schema/data_tables/companion_relationships.rst b/docs/pages/getting_started/template_schema/data_tables/companion_relationships.rst similarity index 100% rename from docs/pages/template_schema/data_tables/companion_relationships.rst rename to docs/pages/getting_started/template_schema/data_tables/companion_relationships.rst diff --git a/docs/pages/template_schema/data_tables/companionparameters.rst b/docs/pages/getting_started/template_schema/data_tables/companionparameters.rst similarity index 100% rename from docs/pages/template_schema/data_tables/companionparameters.rst rename to docs/pages/getting_started/template_schema/data_tables/companionparameters.rst diff --git a/docs/pages/template_schema/data_tables/index.rst b/docs/pages/getting_started/template_schema/data_tables/index.rst similarity index 100% rename from docs/pages/template_schema/data_tables/index.rst rename to docs/pages/getting_started/template_schema/data_tables/index.rst diff --git a/docs/pages/template_schema/data_tables/modeledparameters.rst b/docs/pages/getting_started/template_schema/data_tables/modeledparameters.rst similarity index 100% rename from docs/pages/template_schema/data_tables/modeledparameters.rst rename to docs/pages/getting_started/template_schema/data_tables/modeledparameters.rst diff --git a/docs/pages/template_schema/data_tables/parallaxes.rst b/docs/pages/getting_started/template_schema/data_tables/parallaxes.rst similarity index 100% rename from docs/pages/template_schema/data_tables/parallaxes.rst rename to docs/pages/getting_started/template_schema/data_tables/parallaxes.rst diff --git a/docs/pages/template_schema/data_tables/photometry.rst b/docs/pages/getting_started/template_schema/data_tables/photometry.rst similarity index 100% rename from docs/pages/template_schema/data_tables/photometry.rst rename to docs/pages/getting_started/template_schema/data_tables/photometry.rst diff --git a/docs/pages/template_schema/data_tables/propermotions.rst b/docs/pages/getting_started/template_schema/data_tables/propermotions.rst similarity index 100% rename from docs/pages/template_schema/data_tables/propermotions.rst rename to docs/pages/getting_started/template_schema/data_tables/propermotions.rst diff --git a/docs/pages/template_schema/data_tables/radialvelocities.rst b/docs/pages/getting_started/template_schema/data_tables/radialvelocities.rst similarity index 100% rename from docs/pages/template_schema/data_tables/radialvelocities.rst rename to docs/pages/getting_started/template_schema/data_tables/radialvelocities.rst diff --git a/docs/pages/template_schema/data_tables/rotationalparameters.rst b/docs/pages/getting_started/template_schema/data_tables/rotationalparameters.rst similarity index 100% rename from docs/pages/template_schema/data_tables/rotationalparameters.rst rename to docs/pages/getting_started/template_schema/data_tables/rotationalparameters.rst diff --git a/docs/pages/template_schema/data_tables/sourcetypes.rst b/docs/pages/getting_started/template_schema/data_tables/sourcetypes.rst similarity index 100% rename from docs/pages/template_schema/data_tables/sourcetypes.rst rename to docs/pages/getting_started/template_schema/data_tables/sourcetypes.rst diff --git a/docs/pages/template_schema/data_tables/spectra.rst b/docs/pages/getting_started/template_schema/data_tables/spectra.rst similarity index 100% rename from docs/pages/template_schema/data_tables/spectra.rst rename to docs/pages/getting_started/template_schema/data_tables/spectra.rst diff --git a/docs/pages/template_schema/lookup_tables/associationlist.rst b/docs/pages/getting_started/template_schema/lookup_tables/associationlist.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/associationlist.rst rename to docs/pages/getting_started/template_schema/lookup_tables/associationlist.rst diff --git a/docs/pages/template_schema/lookup_tables/companionlist.rst b/docs/pages/getting_started/template_schema/lookup_tables/companionlist.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/companionlist.rst rename to docs/pages/getting_started/template_schema/lookup_tables/companionlist.rst diff --git a/docs/pages/template_schema/lookup_tables/index.rst b/docs/pages/getting_started/template_schema/lookup_tables/index.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/index.rst rename to docs/pages/getting_started/template_schema/lookup_tables/index.rst diff --git a/docs/pages/template_schema/lookup_tables/instruments.rst b/docs/pages/getting_started/template_schema/lookup_tables/instruments.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/instruments.rst rename to docs/pages/getting_started/template_schema/lookup_tables/instruments.rst diff --git a/docs/pages/template_schema/lookup_tables/parameterlist.rst b/docs/pages/getting_started/template_schema/lookup_tables/parameterlist.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/parameterlist.rst rename to docs/pages/getting_started/template_schema/lookup_tables/parameterlist.rst diff --git a/docs/pages/template_schema/lookup_tables/photometryfilters.rst b/docs/pages/getting_started/template_schema/lookup_tables/photometryfilters.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/photometryfilters.rst rename to docs/pages/getting_started/template_schema/lookup_tables/photometryfilters.rst diff --git a/docs/pages/template_schema/lookup_tables/publications.rst b/docs/pages/getting_started/template_schema/lookup_tables/publications.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/publications.rst rename to docs/pages/getting_started/template_schema/lookup_tables/publications.rst diff --git a/docs/pages/template_schema/lookup_tables/regimelist.rst b/docs/pages/getting_started/template_schema/lookup_tables/regimelist.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/regimelist.rst rename to docs/pages/getting_started/template_schema/lookup_tables/regimelist.rst diff --git a/docs/pages/template_schema/lookup_tables/sourcetypelist.rst b/docs/pages/getting_started/template_schema/lookup_tables/sourcetypelist.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/sourcetypelist.rst rename to docs/pages/getting_started/template_schema/lookup_tables/sourcetypelist.rst diff --git a/docs/pages/template_schema/lookup_tables/telescopes.rst b/docs/pages/getting_started/template_schema/lookup_tables/telescopes.rst similarity index 100% rename from docs/pages/template_schema/lookup_tables/telescopes.rst rename to docs/pages/getting_started/template_schema/lookup_tables/telescopes.rst diff --git a/docs/pages/template_schema/main_tables/index.rst b/docs/pages/getting_started/template_schema/main_tables/index.rst similarity index 100% rename from docs/pages/template_schema/main_tables/index.rst rename to docs/pages/getting_started/template_schema/main_tables/index.rst diff --git a/docs/pages/template_schema/main_tables/names.rst b/docs/pages/getting_started/template_schema/main_tables/names.rst similarity index 100% rename from docs/pages/template_schema/main_tables/names.rst rename to docs/pages/getting_started/template_schema/main_tables/names.rst diff --git a/docs/pages/template_schema/main_tables/sources.rst b/docs/pages/getting_started/template_schema/main_tables/sources.rst similarity index 100% rename from docs/pages/template_schema/main_tables/sources.rst rename to docs/pages/getting_started/template_schema/main_tables/sources.rst diff --git a/docs/pages/template_schema/main_tables/versions.rst b/docs/pages/getting_started/template_schema/main_tables/versions.rst similarity index 100% rename from docs/pages/template_schema/main_tables/versions.rst rename to docs/pages/getting_started/template_schema/main_tables/versions.rst diff --git a/docs/pages/template_schema/template_schema.rst b/docs/pages/getting_started/template_schema/template_schema.rst similarity index 100% rename from docs/pages/template_schema/template_schema.rst rename to docs/pages/getting_started/template_schema/template_schema.rst diff --git a/docs/pages/api.rst b/docs/pages/reference/api.rst similarity index 100% rename from docs/pages/api.rst rename to docs/pages/reference/api.rst diff --git a/docs/pages/dev_docs/developer_installation.rst b/docs/pages/reference/developer_installation.rst similarity index 100% rename from docs/pages/dev_docs/developer_installation.rst rename to docs/pages/reference/developer_installation.rst diff --git a/docs/pages/dev_docs/documentation.rst b/docs/pages/reference/documentation.rst similarity index 80% rename from docs/pages/dev_docs/documentation.rst rename to docs/pages/reference/documentation.rst index 9343a02..63ac828 100644 --- a/docs/pages/dev_docs/documentation.rst +++ b/docs/pages/reference/documentation.rst @@ -16,6 +16,6 @@ To build the docs, use `sphinx-autobuild . diff --git a/docs/pages/reference/index.rst b/docs/pages/reference/index.rst new file mode 100644 index 0000000..a4da8f5 --- /dev/null +++ b/docs/pages/reference/index.rst @@ -0,0 +1,9 @@ +Reference Information +===================== + +.. toctree:: + :glob: + :maxdepth: 2 + + developer_installation + api \ No newline at end of file diff --git a/docs/pages/dev_docs/ingest_functions.rst b/docs/pages/reference/ingest_functions.rst similarity index 100% rename from docs/pages/dev_docs/ingest_functions.rst rename to docs/pages/reference/ingest_functions.rst diff --git a/docs/pages/getting_help/faq.rst b/docs/pages/utilities/getting_help/faq.rst similarity index 100% rename from docs/pages/getting_help/faq.rst rename to docs/pages/utilities/getting_help/faq.rst diff --git a/docs/pages/getting_help/index.rst b/docs/pages/utilities/getting_help/index.rst similarity index 100% rename from docs/pages/getting_help/index.rst rename to docs/pages/utilities/getting_help/index.rst diff --git a/docs/pages/utilities/index.rst b/docs/pages/utilities/index.rst new file mode 100644 index 0000000..f7dc765 --- /dev/null +++ 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/docs/pages/ingesting/spectra/converting_spectra/converting_spectra.rst b/docs/pages/utilities/spectra/converting_spectra/converting_spectra.rst similarity index 100% rename from docs/pages/ingesting/spectra/converting_spectra/converting_spectra.rst rename to docs/pages/utilities/spectra/converting_spectra/converting_spectra.rst diff --git a/docs/pages/ingesting/spectra/converting_spectra/fits_header_modify.ipynb b/docs/pages/utilities/spectra/converting_spectra/fits_header_modify.ipynb similarity index 100% rename from docs/pages/ingesting/spectra/converting_spectra/fits_header_modify.ipynb rename to docs/pages/utilities/spectra/converting_spectra/fits_header_modify.ipynb diff --git a/docs/pages/ingesting/spectra/converting_spectra/fits_header_scratch.ipynb b/docs/pages/utilities/spectra/converting_spectra/fits_header_scratch.ipynb similarity index 100% rename from docs/pages/ingesting/spectra/converting_spectra/fits_header_scratch.ipynb rename to docs/pages/utilities/spectra/converting_spectra/fits_header_scratch.ipynb diff --git a/docs/pages/ingesting/spectra/index.rst b/docs/pages/utilities/spectra/index.rst similarity index 100% rename from docs/pages/ingesting/spectra/index.rst rename to docs/pages/utilities/spectra/index.rst From 4ee9713556f4236e113bf0ab90cade43c2aed7aa Mon Sep 17 00:00:00 2001 From: David Rodriguez Date: Tue, 3 Feb 2026 17:10:01 -0500 Subject: [PATCH 5/6] moving files to new directories --- .../ingesting/getting_started_ingesting.rst | 4 +-- .../ingesting}/ingest_scripts/index.rst | 0 .../ingest_scripts/writing_scripts.rst | 0 docs/pages/utilities/index.rst | 28 +++---------------- 4 files changed, 5 insertions(+), 27 deletions(-) rename docs/pages/{utilities => db_access/ingesting}/ingest_scripts/index.rst (100%) rename docs/pages/{utilities => db_access/ingesting}/ingest_scripts/writing_scripts.rst (100%) diff --git a/docs/pages/db_access/ingesting/getting_started_ingesting.rst b/docs/pages/db_access/ingesting/getting_started_ingesting.rst index 099c862..51ca77f 100644 --- a/docs/pages/db_access/ingesting/getting_started_ingesting.rst +++ b/docs/pages/db_access/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/docs/pages/utilities/ingest_scripts/index.rst b/docs/pages/db_access/ingesting/ingest_scripts/index.rst similarity index 100% rename from docs/pages/utilities/ingest_scripts/index.rst rename to docs/pages/db_access/ingesting/ingest_scripts/index.rst diff --git a/docs/pages/utilities/ingest_scripts/writing_scripts.rst b/docs/pages/db_access/ingesting/ingest_scripts/writing_scripts.rst similarity index 100% rename from docs/pages/utilities/ingest_scripts/writing_scripts.rst rename to docs/pages/db_access/ingesting/ingest_scripts/writing_scripts.rst diff --git a/docs/pages/utilities/index.rst b/docs/pages/utilities/index.rst index 099c862..f7dc765 100644 --- a/docs/pages/utilities/index.rst +++ b/docs/pages/utilities/index.rst @@ -1,29 +1,9 @@ -Ingesting and Modifying Data -============================ +Utilities and support +===================== .. toctree:: :glob: :maxdepth: 2 - :titlesonly: - 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`. - - -API Documentation ------------------ - -:py:mod:`astrodb_utils.sources.ingest_source` - Function to ingest source data - -:py:mod:`astrodb_utils.sources.ingest_names` - Function to ingest alternative name data - -:py:mod:`astrodb_utils.utils.ingest_instrument` - Function to ingest instrument data + spectra/index + getting_help/index From 617ed0e89bfc6b8237ff2e8f4384ea7e6f93d61d Mon Sep 17 00:00:00 2001 From: David Rodriguez Date: Tue, 3 Feb 2026 17:20:48 -0500 Subject: [PATCH 6/6] fixing bugs in rst files --- .../db_access/ingesting/ingesting_publications.rst | 3 ++- docs/pages/db_access/querying_existing_db/index.rst | 4 ++-- docs/pages/reference/api.rst | 8 +------- docs/pages/utilities/spectra/index.rst | 11 ++++++----- 4 files changed, 11 insertions(+), 15 deletions(-) diff --git a/docs/pages/db_access/ingesting/ingesting_publications.rst b/docs/pages/db_access/ingesting/ingesting_publications.rst index 9434ac2..73e1341 100644 --- a/docs/pages/db_access/ingesting/ingesting_publications.rst +++ b/docs/pages/db_access/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 ` function diff --git a/docs/pages/db_access/querying_existing_db/index.rst b/docs/pages/db_access/querying_existing_db/index.rst index e1946c0..63227ba 100644 --- a/docs/pages/db_access/querying_existing_db/index.rst +++ b/docs/pages/db_access/querying_existing_db/index.rst @@ -1,5 +1,5 @@ -Querying -======== +Querying the database +===================== Create the Database ------------------------ diff --git a/docs/pages/reference/api.rst b/docs/pages/reference/api.rst index f1ba2e8..1f74053 100644 --- a/docs/pages/reference/api.rst +++ b/docs/pages/reference/api.rst @@ -53,6 +53,7 @@ Publications :members: :undoc-members: :show-inheritance: + Instruments ------------ @@ -60,10 +61,3 @@ Instruments :members: :undoc-members: :show-inheritance: - -Loaders ------------- -.. automodule:: astrodb_utils.loaders - :members: - :undoc-members: - :show-inheritance: \ No newline at end of file diff --git a/docs/pages/utilities/spectra/index.rst b/docs/pages/utilities/spectra/index.rst index 83def96..c9c85f4 100644 --- a/docs/pages/utilities/spectra/index.rst +++ b/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 = - plottable = check_spectrum_plottable(file, show_plot=True) - print plottable + + from astrodb_utils.spectra import check_spectrum_plottable + file = + plottable = check_spectrum_plottable(file, show_plot=True) + print plottable - > True + > True