Changes in TOC with first suggestion #434
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -34,82 +34,29 @@ website: | |||||||||||||||||
| search: true | ||||||||||||||||||
| collapse-level: 1 | ||||||||||||||||||
| contents: | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| # SECTION 1: GETTING STARTED | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "Getting Started" | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "Welcome" | ||||||||||||||||||
| href: index.qmd | ||||||||||||||||||
| - text: "When To Cloud" | ||||||||||||||||||
| href: when-to-cloud.qmd | ||||||||||||||||||
| - text: "Cloud Environment Setup" | ||||||||||||||||||
| href: environment-setup/index.qmd | ||||||||||||||||||
| - text: "Glossary & Cheatsheets" | ||||||||||||||||||
| href: glossary.qmd | ||||||||||||||||||
|
Comment on lines
+44
to
+49
Contributor
There was a problem hiding this comment. Perhaps the "When To Cloud" and "Glossary & Cheatsheets" sections would be better placed in the "Reference" section?
Suggested change
Member
There was a problem hiding this comment. I agree about Glossary and Cheat sheets moving to "References", but I think @alexishunzinger current WIP cheat sheet should be given higher exposure when she's ready to share it. People really like cheat sheets, and would be less likely to find it if it's in "References" I think. I think there's an argument for "When to Cloud" to still live in "Getting Started" |
||||||||||||||||||
|
|
||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| # SECTION 2: TUTORIALS (Learn by Doing) | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "Tutorials (Learn by Doing)" | ||||||||||||||||||
| href: tutorials/index.qmd | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "Earthdata Cloud Clinic" | ||||||||||||||||||
| href: tutorials/Earthdata-cloud-clinic.ipynb | ||||||||||||||||||
| - text: "Multi-datasets (Hurricanes)" | ||||||||||||||||||
| href: tutorials/Hurricanes_Wind_and_Sea_Surface_Temperature.ipynb | ||||||||||||||||||
| - text: "Sea Level Rise" | ||||||||||||||||||
| href: tutorials/Sea_Level_Rise.ipynb | ||||||||||||||||||
|
|
@@ -119,74 +66,215 @@ website: | |||||||||||||||||
| href: tutorials/Observing_Seasonal_Ag_Changes.ipynb | ||||||||||||||||||
| - text: "Subsetting Data with Harmony" | ||||||||||||||||||
| href: tutorials/Harmony.ipynb | ||||||||||||||||||
| - 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 | ||||||||||||||||||
| - text: "ICESat-2 Visualization" | ||||||||||||||||||
| href: tutorials/make_atl03_figure.ipynb | ||||||||||||||||||
| - text: "Data Stories Template" | ||||||||||||||||||
| href: tutorials/Data_stories_template.ipynb | ||||||||||||||||||
|
|
||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| # SECTION 3: HOW-TO GUIDES (Solve Specific Problems) | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "How-To Guides (Solve Specific Problems)" | ||||||||||||||||||
| contents: | ||||||||||||||||||
|
Comment on lines
-142
to
-143
Contributor
There was a problem hiding this comment. I think I'm okay with not having an "In Development" section. I suppose that means we'll keep in-development work to branches other than
Member
Author
There was a problem hiding this comment. Yes, I think it would be better to use branches, instead of keeping the files floating in the main branch. And using releases after reviews. I removed that section from the TOC, but yes, we need discuss further how to handle those files. I feel that some of the files could be better tracked as issues (task/to-do). For content that is further developed, but still not ready to be part of the published version of the book, I suggest moving it to its intended location and opening a draft PR for review in different branches as you said. |
||||||||||||||||||
| - 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 | ||||||||||||||||||
| - 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 4: EXAMPLES BY DATA PROVIDER | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "Examples by Data Provider" | ||||||||||||||||||
| href: examples/index.qmd | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - section: "GES DISC" | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "MERRA2 with Kerchunk" | ||||||||||||||||||
| href: examples/GESDISC/GESDISC_MERRA2_tavg1_2d_flx_Nx__Kerchunk.ipynb | ||||||||||||||||||
| - 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 | ||||||||||||||||||
| - 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 | ||||||||||||||||||
| - section: "USGS" | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "Landsat C2 Search & Access" | ||||||||||||||||||
| href: examples/USGS_Landsat/Landsat_C2_Search_Access.ipynb | ||||||||||||||||||
| - text: "Direct Access & Harmony Workflow" | ||||||||||||||||||
| href: examples/Transform-workflow.ipynb | ||||||||||||||||||
|
|
||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| # SECTION 5: EXTERNAL TUTORIALS | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - 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 6: REFERENCE | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "Reference" | ||||||||||||||||||
| href: appendix/index.md | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "Authentication" | ||||||||||||||||||
| href: appendix/authentication.qmd | ||||||||||||||||||
| - section: "Alternate Access Methods" | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "Access COG" | ||||||||||||||||||
| href: appendix/appendix-alternate-in-cloud-access/Access_COG.qmd | ||||||||||||||||||
| - text: "Single File HTTPS COG" | ||||||||||||||||||
| href: appendix/appendix-alternate-in-cloud-access/Earthdata_Cloud__Single_File__HTTPS_Access_COG_Example.qmd | ||||||||||||||||||
| - text: "Single File Direct S3 NetCDF" | ||||||||||||||||||
| href: appendix/appendix-alternate-in-cloud-access/Earthdata_Cloud__Single_File__Direct_S3_Access_NetCDF4_Example.ipynb | ||||||||||||||||||
| - text: "Multi-File Direct S3 NetCDF" | ||||||||||||||||||
| href: appendix/appendix-alternate-in-cloud-access/Multi-File_Direct_S3_Access_NetCDF_Example.ipynb | ||||||||||||||||||
|
|
||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| # SECTION 7: COMMUNITY & RESOURCES | ||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "Community & Resources" | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - section: "Our Cookbooks" | ||||||||||||||||||
| href: our-cookbooks.qmd | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "PO.DAAC Tutorials" | ||||||||||||||||||
| href: https://podaac.github.io/tutorials/ | ||||||||||||||||||
| - 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" | ||||||||||||||||||
| href: https://nasa.github.io/oceandata-notebooks/ | ||||||||||||||||||
| - text: "ORNL DAAC Airborne Tutorials" | ||||||||||||||||||
| href: https://ornldaac.github.io/airborne/ | ||||||||||||||||||
| - text: "ORNL DAAC GEDI Tutorials" | ||||||||||||||||||
| href: https://ornldaac.github.io/gedi_tutorials/ | ||||||||||||||||||
| - section: "Workshops & Hackathons" | ||||||||||||||||||
| href: workshops/index.qmd | ||||||||||||||||||
| contents: | ||||||||||||||||||
| - text: "Workshop Setup" | ||||||||||||||||||
| href: workshops/setup.md | ||||||||||||||||||
|
Member
There was a problem hiding this comment. I propose we move the jupyterhub "Getting Started" to https://openscapes.cloud and update it. It's less about accessing/using cloud data, and getting set up in our specific jupyterhub. That said, I think it's worth linking to resources like this from the cookbook |
||||||||||||||||||
| - 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: "Environment" | ||||||||||||||||||
| href: contributing/environment.qmd | ||||||||||||||||||
| - text: "Privacy Policy" | ||||||||||||||||||
| href: privacy.qmd | ||||||||||||||||||
|
|
||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| # SECTION 8: ADMINISTRATION (for maintainers/instructors) | ||||||||||||||||||
|
Member
There was a problem hiding this comment. I think we can remove all of this since it's moved to https://openscapes.cloud |
||||||||||||||||||
| # ============================================================ | ||||||||||||||||||
| - section: "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 | ||||||||||||||||||
|
|
||||||||||||||||||
|
|
||||||||||||||||||
| format: | ||||||||||||||||||
|
|
||||||||||||||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like the organization overall, but wonder if
Welcomeshould be on its at the top, not in a folder?There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
However, if "When to Cloud" and "Glossary and Cheatsheets" are moved to the "Reference Section, that would leave only "Cloud Environment Setup" in the getting started... section.