Skip to content

Re-structuring of TOC #444

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ronnyhdez wants to merge 17 commits into
base: main
Choose a base branch
from
+221 −141
Open

Re-structuring of TOC #444

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
a4cfecb
Ref #427 Changes in TOC with first suggestion
Apr 14, 2026
3a2ba42
Ref #427 re-structuring the TOC with notes from co-working
ronnyhdez May 7, 2026
c024122
Ref #427 move Glossary & Cheatsheets to references
ronnyhdez May 7, 2026
ed5d3d2
Merge branch 'main' into I427
ronnyhdez May 7, 2026
e3da664
Ref #427 merge diff with main
ronnyhdez May 7, 2026
1dd1477
Ref #427 removed admin section
ronnyhdez May 7, 2026
06880eb
Ref #427 move welcome as landing page and change section name
ronnyhdez May 12, 2026
e54932d
Ref #427 move cloud paradigm to core concepts section
ronnyhdez May 12, 2026
a659d2c
Ref #427 make sidebar wider
ronnyhdez May 15, 2026
61b5334
Ref #456 validate Earthdata consistency across the _quarto.yml file
ronnyhdez May 16, 2026
1a443ca
Ref 56 Core Concepts validated in TOC
ronnyhdez May 16, 2026
b9de1c0
Ref #452 moved alternate access methods to community and resources
ronnyhdez May 16, 2026
abf9389
Ref #451 move workshops to community and resources
ronnyhdez May 16, 2026
0986164
Ref #449 add arrow to indicate external link
ronnyhdez May 16, 2026
cde5109
Ref #427 Move single file before daacs subsections
ronnyhdez May 24, 2026
ca59036
Ref #460 changed name to Computing Environment
ronnyhdez May 24, 2026
4d21325
Ref #427 remove the listed appendix files from TOC
ronnyhdez May 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
312 changes: 185 additions & 127 deletions _quarto.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ execute:

website:
page-navigation: true
title: "EarthData Cloud Cookbook"
title: "Earthdata Cloud Cookbook"
site-url: https://nasa-openscapes.github.io/earthdata-cloud-cookbook
repo-url: https://github.com/nasa-openscapes/earthdata-cloud-cookbook
repo-actions: [edit, source, issue]
Expand Down Expand Up @@ -36,80 +36,44 @@ website:
contents:
- text: "Welcome"
href: index.qmd
- text: "When To Cloud"
href: when-to-cloud.qmd
# ============================================================
# SECTION 1: OUR COOKBOOKS (Explanation)
# ============================================================
- section: "Our Cookbooks"
href: our-cookbooks.qmd
contents:
Comment thread
ronnyhdez marked this conversation as resolved.
- text: "Ocean, climate, and surface water data tutorials from PO.DAAC"
- text: "PO.DAAC Tutorials"
href: https://podaac.github.io/tutorials/
- text: "Mission-specific tutorials for ASDC"
href: https://nasa.github.io/ASDC_Data_and_User_Services/
- text: "Tutorials from the National Snow and Ice Data Center (NSIDC)"
href: https://nsidc.github.io/NSIDC-Data-Cookbook/
- text: "Ocean Data Cookbook from OBDAAC"
- text: "ASDC Mission Tutorials"
href: https://nasa.github.io/ASDC_Data_and_User_Services/
- text: "NSIDC Data Cookbook"
href: https://nsidc.github.io/NSIDC-Data-Cookbook/
- text: "OBDAAC Ocean Data Cookbook"
Copy link
Copy Markdown
Contributor

@itcarroll itcarroll May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- text: "OBDAAC Ocean Data Cookbook"
- text: "OB.DAAC Help Hub"

Copy link
Copy Markdown
Contributor

@itcarroll itcarroll May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "." is important for our DAACs branding, and the "Help Hub" is the cookbook's current title. If you just want to have "OB.DAAC Tutorials", that's okay too.

href: https://nasa.github.io/oceandata-notebooks/
- text: "Airborne Data Tutorials from ORNL DAAC"
href: https://ornldaac.github.io/airborne/
- text: "GEDI Data Tutorials from ORNL DAAC"
href: https://ornldaac.github.io/gedi_tutorials/
- text: "Glossary & Cheatsheets"
href: glossary.qmd
- text: "Cloud Environment Setup"
href: environment-setup/index.qmd
- section: "How do I..."
contents:
- section: "find data"
contents:
- text: "with Earthdata Search"
href: how-tos/find-data/earthdata_search.md
- text: "with Python"
href: how-tos/find-data/find-python.ipynb
- text: "with R"
href: how-tos/find-data/find-r.qmd
- text: "with R and STAC"
href: how-tos/find-data/CMR-STAC-Search.qmd
- section: "access data in cloud"
contents:
- text: "with Python"
href: how-tos/access-data/access-cloud-python.ipynb
# - text: "with R"
# href: how-tos/access-data/access-cloud-r.qmd
- section: "access data locally"
contents:
- text: "with Python"
href: how-tos/access-data/access-local-python.ipynb
- text: "with OPeNDAP"
href: how-tos/access-data/access-local-opendap.qmd
- text: "with command line"
href: how-tos/access-data/access-command-line.md
- text: "read data"
href: how-tos/read_data.qmd
- text: "subset data"
href: how-tos/subset.qmd
- text: "Store data in the cloud"
href: how-tos/using-s3-storage.ipynb
#- text: "reformat data files"
# href: how-tos/reformat.qmd
#- text: "reproject and regrid"
# href: how-tos/reproject_regrid.qmd
#- text: "aggregate data"
# href: how-tos/aggregate.qmd
#- text: "plot data"
# href: how-tos/plot.qmd
- section: "use APIs"
href: how-tos/use_apis.qmd
contents:
- text: "AppEEARS Cloud CSV Access "
href: external/appeears_csv_cloud_access.ipynb
- text: "parking lot"
href: how-tos/how_to_guide_parking_lot.qmd
- section: "Tutorials"
- text: "ORNL DAAC Airborne Tutorials"
href: https://ornldaac.github.io/airborne/
- text: "ORNL DAAC GEDI Tutorials"
href: https://ornldaac.github.io/gedi_tutorials/

# ============================================================
# SECTION 2: CORE CONCEPTS (conceptual, the "why")
# ============================================================
- section: "Core Concepts"
contents:
- text: "Cloud Paradigm"
href: cloud_paradigm.qmd
- text: "When To Cloud"
href: when-to-cloud.qmd

# ============================================================
# SECTION 3: TUTORIALS (Learn by doing, end-to-end)
# ============================================================
- section: "Tutorials (Learn by Doing)"
href: tutorials/index.qmd
contents:
- text: "Earthdata Cloud Clinic"
href: tutorials/Earthdata-cloud-clinic.ipynb
- text: "Multi-datasets"
- text: "Multi-datasets (Hurricanes)"
href: tutorials/Hurricanes_Wind_and_Sea_Surface_Temperature.ipynb
- text: "Sea Level Rise"
href: tutorials/Sea_Level_Rise.ipynb
Expand All @@ -119,86 +83,178 @@ website:
href: tutorials/Observing_Seasonal_Ag_Changes.ipynb
- text: "Subsetting Data with Harmony"
href: tutorials/Harmony.ipynb
- text: "OPeNDAP Access"
- text: "OPeNDAP Access"
href: tutorials/Earthdata_Cloud__Data_Access_OPeNDAP_Example.ipynb
- text: "Pygeoweaver Workflow Demo"
href: tutorials/fair-workflow-geoweaver-demo.ipynb
- text: "MATLAB Access NetCDF"
href: tutorials/matlab.qmd
- section: "Workshops & Hackathons"
href: workshops/index.qmd
contents:
- text: "Workshop Setup"
href: workshops/setup.md
- section: "Access & Administration"
href: access-admin/index.qmd
contents:
- text: "2i2c Hub access"
href: access-admin/add-folks-to-2i2c-github-teams.qmd
- text: "Data storage"
href: access-admin/data-storage.qmd
- text: "Leading workshops"
href: access-admin/leading-workshops.qmd
Comment thread
ronnyhdez marked this conversation as resolved.
- section: "In Development"
href: in-development/index.qmd
contents:
- text: "Search & Download NSIDC Cloud"
href: examples/NSIDC/ICESat2-CMR-OnPrem-vs-Cloud.ipynb
- text: "Access NSIDC Cloud w/ CMR"
href: examples/NSIDC/ICESat2-CMR-AWS-S3.ipynb
- text: "ICESat-2 Visualization"
href: tutorials/make_atl03_figure.ipynb
- text: "Data Stories Template"
href: tutorials/Data_stories_template.ipynb
# - section: "External Tutorials"
# contents:
- text: "NASA Earthdata Authentication"
href: external/nasa_earthdata_authentication.ipynb
- text: "CMR Data Discovery"
href: external/data_discovery_cmr.ipynb
- text: "CMR-STAC API Discovery"
href: external/data_discovery_cmr-stac_api.ipynb
- text: "Harmony Subsetting"
href: external/harmony_subsetting.ipynb
- text: "Direct S3 Access Patterns"
href: external/data_access_direct_S3.ipynb
- text: "On-Prem vs Cloud Workflows"
href: external/on-prem_cloud.ipynb
- text: "Zarr-EOSDIS-Store"
href: external/zarr-eosdis-store.ipynb
- text: "COF Zarr Reformat"
href: external/cof-zarr-reformat.ipynb
- text: "Xarray Fundamentals"
href: external/xarray.ipynb
- text: "Sentinel-6 OPeNDAP & Gridding"
href: external/sentinel-6_opendap_access_gridding.ipynb
# - section: "Examples by Data Provider"
# href: examples/index.qmd
# contents:
- text: "Direct Access & Harmony Workflow"
href: examples/Transform-workflow.ipynb
- text: "Search & Access USGS Landsat Cloud"
href: examples/USGS_Landsat/Landsat_C2_Search_Access.ipynb
- text: "Direct S3 Data Access: NetCDF - Daymet v4 Daily TMAX Example"
href: examples/ORNL/Data_Access__Direct_S3_Access__ORNL_DAYMET.ipynb
- text: "Access ECCO data via Harmony & the Zarr reformatter service"
href: external/cof-zarr-reformat.ipynb
- text: "zarr-eosdis-store example"
href: external/zarr-eosdis-store.ipynb
- section: "Example Workflows"
href: examples/index.qmd
contents:
- text: "GES DISC - MERRA2"
- section: "GES DISC"
contents:
- text: "MERRA2 with Kerchunk"
href: examples/GESDISC/GESDISC_MERRA2_tavg1_2d_flx_Nx__Kerchunk.ipynb
- text: "LP DAAC ECOSTRESS"
- section: "LP DAAC"
contents:
- text: "HLS Point Buffer Search & Access"
href: examples/LPDAAC/Find_and_Access_HLS_PointBuffer.ipynb
- text: "ECOSTRESS with Kerchunk"
href: examples/LPDAAC/LPDAAC_ECOSTRESS_LSTE__Kerchunk.ipynb
- text: "PO.DAAC ECCO SSH"
- section: "NSIDC"
contents:
- text: "ICESat-2 OnPrem vs Cloud"
href: examples/NSIDC/ICESat2-CMR-OnPrem-vs-Cloud.ipynb
- text: "ICESat-2 CMR & AWS S3"
href: examples/NSIDC/ICESat2-CMR-AWS-S3.ipynb
- section: "ORNL DAAC"
contents:
- text: "DAYMET Direct S3 Access"
href: examples/ORNL/Data_Access__Direct_S3_Access__ORNL_DAYMET.ipynb
- text: "DAYMET with Kerchunk"
href: examples/ORNL/ORNL_DAYMET__Kerchunk.ipynb
- section: "PO.DAAC"
contents:
- text: "ECCO SSH with Kerchunk"
href: examples/PODAAC/PODAAC_ECCO_SSH__Kerchunk.ipynb
- text: "`earthdata`: Python-R Handoff"
href: in-development/earthdata-python-r-handoff.qmd
- section: "Contributing"
href: contributing/index.qmd
- section: "USGS"
contents:
- text: "Landsat C2 Search & Access"
href: examples/USGS_Landsat/Landsat_C2_Search_Access.ipynb

# ============================================================
# SECTION 4: HOW-TO GUIDES (goal-oriented, assumes contex)
# ============================================================
- section: "How-To Guides (goal-oriented, assumes context)"
Copy link
Copy Markdown
Contributor

@itcarroll itcarroll May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- section: "How-To Guides (goal-oriented, assumes context)"
- section: "How-To Guides (Do a Task)"

Noted in May 7 co-working notes.

contents:
- text: "Calendaring and Project Management"
href: contributing/calendar-project-management.qmd
- text: "Onboarding Mentors"
href: contributing/onboarding.qmd
- text: "Setup"
href: contributing/setup.qmd
- text: "Workflows"
href: contributing/workflow.qmd
- text: "Quarto Tutorial"
href: contributing/quarto-website-tutorial.md
- text: "Troubleshooting"
href: contributing/troubleshooting.md
- section: "Templates"
- section: "Find Data"
contents:
- text: "Python Jupyter Notebook Template"
href: contributing/templates/notebook-template-python-jupyter.ipynb
- text: "Python Quarto Template"
href: contributing/templates/notebook-template-python-quarto.qmd
- text: "R Quarto Template"
href: contributing/templates/notebook-template-r-quarto.qmd
- section: "Appendix"
- text: "with Earthdata Search"
href: how-tos/find-data/earthdata_search.md
- text: "with Python"
href: how-tos/find-data/find-python.ipynb
- text: "with R"
href: how-tos/find-data/find-r.qmd
- text: "with R and STAC"
href: how-tos/find-data/CMR-STAC-Search.qmd
- text: "Programmatic Discovery"
href: how-tos/find-data/programmatic.qmd
- section: "Access Data in Cloud"
contents:
- text: "with Python"
href: how-tos/access-data/access-cloud-python.ipynb
- section: "Access Data Locally"
contents:
- text: "with Python"
href: how-tos/access-data/access-local-python.ipynb
- text: "with OPeNDAP"
href: how-tos/access-data/access-local-opendap.qmd
- text: "with Command Line"
href: how-tos/access-data/access-command-line.md
- section: "Work with Data"
contents:
- text: "Read Data"
href: how-tos/read_data.qmd
- text: "Subset Data"
href: how-tos/subset.qmd
- text: "Store Data in S3"
href: how-tos/using-s3-storage.ipynb
# - text: "Reformat Data Files"
# href: how-tos/reformat.qmd
# - text: "Reproject and Regrid"
# href: how-tos/reproject_regrid.qmd
# - text: "Aggregate Data"
# href: how-tos/aggregate.qmd
# - text: "Plot Data"
# href: how-tos/plot.qmd
- section: "Use APIs"
href: how-tos/use_apis.qmd
contents:
- text: "AppEEARS Cloud CSV Access"
href: external/appeears_csv_cloud_access.ipynb
- text: "Open Science Tutorial"
href: how-tos/Earthdata_Cloud__Open-Science-Tutorial.ipynb
- text: "Parking Lot"
href: how-tos/how_to_guide_parking_lot.qmd

# ============================================================
# SECTION 5: REFERENCE
# ============================================================
- section: "Reference"
href: appendix/index.md
contents:
- text: "Glossary & Cheatsheets"
href: glossary.qmd
- text: "Authentication"
href: appendix/authentication.qmd


# ============================================================
# SECTION 7: COMMUNITY & RESOURCES
# ============================================================
- section: "Community & Resources"
contents:
- section: "Contributing"
href: contributing/index.qmd
contents:
- text: "Calendaring and Project Management"
href: contributing/calendar-project-management.qmd
- text: "Onboarding Mentors"
href: contributing/onboarding.qmd
- text: "Setup"
href: contributing/setup.qmd
- text: "Workflows"
href: contributing/workflow.qmd
- text: "Quarto Tutorial"
href: contributing/quarto-website-tutorial.md
- text: "Troubleshooting"
href: contributing/troubleshooting.md
- text: "Community Guidelines"
href: contributing/community.md
- text: "Computing Environment"
href: contributing/environment.qmd
- section: "Workshops & Hackathons"
Comment thread
ronnyhdez marked this conversation as resolved.
href: workshops/index.qmd
contents:
- text: "Workshop Setup"
href: workshops/setup.md
- text: "Cloud Environment Setup"
href: environment-setup/index.qmd
- text: "Privacy Policy"
href: privacy.qmd

format:
html:
grid:
sidebar-width: 500px
Comment thread
ronnyhdez marked this conversation as resolved.
Copy link
Copy Markdown
Contributor

@itcarroll itcarroll May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps the width could be a bit less, given the shorter heading of "How-To Guides (Do a Task)".

include-in-header: _ga-consent-defaults.html
theme:
light: cosmo
Expand All @@ -207,6 +263,8 @@ format:
code-copy: true
css: styles.css
toc: true
link-external-icon: true
Comment thread
ateucher marked this conversation as resolved.
link-external-newwindow: true
Comment thread
ronnyhdez marked this conversation as resolved.

filters:
- include-files.lua
Expand Down
Loading
Loading