6. Update Quarto executable syntax throughout .qmds and document

[stefaniebutland]

About: https://github.com/NASA-Openscapes/earthdata-cloud-cookbook/issues/228#issuecomment-1664652612

• [x] Stef do setup.qmd update first
  • PR #240
• [x] Make checklist of all .qmds we see in the yaml (done Aug 4, 2023)
• [ ] Stef and Julie update them in one branch in one coworking session
• [ ] Look for code chunks in .qmd files. Code chunks in RStudio will be grey; could control-F for ```
• [ ] Document this

[stefaniebutland]

Checklist of .qmd files in earthdata-cloud-cookbook/_quarto.yml as of Aug 4, 2023

• [x] index.qmd
• [x] when-to-cloud.qmd
• [x] our-cookbook.qmd
• [x] cheatsheets.qmd
• [x] environment-setup/index.qmd
• [ ] ~how-tos/index.qmd~ file does not exist
• [ ] ~how-tos/find-data/index.md~ file does not exist
• [x] how-tos/find-data/earthdata_search.md
• [x] how-tos/find-data/programmatic.qmd
• [x] how-tos/access_data.qmd
• [x] how-tos/if-im-in-the-cloud.qmd
• [x] how-tos/if-im-local.qmd
• [x] how-tos/read_data.qmd
• [x] how-tos/subset.qmd
• [x] how-tos/reformat.qmd
• [x] how-tos/reproject_regrid.qmd
• [x] how-tos/aggregate.qmd
• [x] how-tos/plot.qmd
• [x] how-tos/use_apis.qmd
• [ ] ~how-tos/tech-setup.qmd~ file does not exist
• [x] how-tos/how_to_guide_parking_lot.md
• [x] how-tos/working-with-data-in-cloud/ @jules32 pls check this folder > checked and tagged Mentors in comment below
• [x] tutorials/index.qmd
• [x] workshops/index.qmd
• [x] workshops/setup.md
• [x] examples/index.qmd
• [ ] in-development/index.qmd
• [ ] in-development/matlab.qmd
• [ ] in-development/CMR-STAC-Search.Rmd
• [ ] in-development/earthdata-python-r-handoff.qmd
• [x] contributing/index.qmd
• [x] contributing/setup.qmd
• [x] contributing/workflow.qmd
• [x] contributing/quarto-website-tutorial.md
• [x] contributing/troubleshooting.md
• [x] contributing/onboarding.qmd
• [x] appendix/index.md
• [x] appendix/authentication.qmd @jules32 please check > checked & updated

[stefaniebutland]

Set as e.g.

```python

in almost all of these qmd files.

From Julie:

I think that will be true for 80-90% of the .qmds, there may be a few that are more complex. If you have questions about any of them will you skip, but otherwise I think you can do most of them! I think Amy and Andy are the ones who have made .qmds and most other folks make .ipynbs

[stefaniebutland]

Julie will help with in-development ones. Stef do the others.

[stefaniebutland]

Files not appearing in _quarto.yml

• [x] contributing/community.md
• [x] contributing/environment.qmd
• [x] contributing/slides.md

[stefaniebutland]

working in draft PR: https://github.com/NASA-Openscapes/earthdata-cloud-cookbook/pull/244

[jules32]

For these files in the checklist above, let's ask @cassienickles @ScienceCat18 and others on Aug 29 during coworking. I'm not sure this is the way Mentors are teaching these topics currently. https://github.com/NASA-Openscapes/earthdata-cloud-cookbook/tree/main/how-tos/working-with-data-in-cloud

[stefaniebutland]

@ScienceCat18 says most of these have been superseeded by Earthaccess now

[jules32]

Found a few more from how-tos/working-with-data-in-cloud/ that I fixed when we moved to the Appendix following Coworking today - and checked off in the above list.

Addressed them since moving them affected the Cookbook's ability to build