open issues for all markdown files needed for JupyterBook TOC

[amsnyder]

Open and issue for each additional markdown file needed by the JupyterBook TOC so that we can assign people to build this content. This task is related to #118.

[gzt5142]

I wonder if it would be OK if we just list those files here in a task list rather than a separate issue for each?

First step is to agree on the outline structure -- seems like we've had a couple of ideas here and there... would be nice to get something nailed down. See, for example, the sample outline and choices here:

https://github.com/hytest-org/hytest/issues/268#issuecomment-1492337970

Personally, I think that adding depth to the outline is better than breadth, so I'm a fan of the extra layer (chapter/section/sub-section , rather than just chapter/section)

Given the current TOC, the sub-section container documents we need are:

• [x] About.md
• [x] environment_set_up/clusters.md
• [x] dataset_preprocessing/chunk.md ## see note below
• [x] evaluation/metrics.md

That's it for now... but as sections get approved for inclusion, some will need to be added, depending on the TOC decisions made to include those new sections. Hard to know what to include now before that material gets written.

Note on the chunk.md doc... It seems like @rsignell-usgs 's documentation project is expected to become a section to include here in place of these two or three files. That's not to say that we don't need this doc now, but just that it will change if/when that other material gets folded into this repo.

[gzt5142]

• About

Environment Set-Up

• Compute Environment
  • QuickStart-Cloud-Nebari
  • QuickStart-Cloud-pangeoCHS
  • OpenOnDemand
  • JupyterForward
  • StartScript
• Starting A Cluster
  • Help_AWS_Credentials
  • Start_Dask_Cluster_Nebari
  • Start_Dask_Cluster_PangeoCHS
  • Start_Dask_Cluster_Denali
  • Start_Dask_Cluster_Tallgrass

Getting Started

• ReadingsTutorials
• DataSources
  • Data_APIs
  • Data_S3
  • Data_STAC
• Parallelism with Dask
• "Chunking" data
  • ReChunkingData
  • ReChunkingData_Cloud

Dataset Access

• hytest catalogs
  • catalog
  • sub-catalogs
• CONUS404 Access
  • Explore CONUS404

Model Evaluation Tutorials

• metrics
  • Metrics_DScore_Suite_v1
  • Usage_DScore_Suite_v1
  • Metrics_StdSuite_v1
  • Usage_StdSuite_v1
• NWM StreamFlow
  • 01_Data_Prep
  • 02_Analysis_StdSuite
  • 02_Analysis_DScore
  • 03_Vizualization

Supplementary

• CONTRIBUTING
• LICENSE

[gzt5142]

Some nomenclature:

In the above sample (the current state of the TOC, more or less),

• "Parts" are bold and big (Supplementary, Environment Set-Up, ...)
• "Chapters" are the first level of bullet list (black dots)
• "Sections" are the next level (white dots)
• "Sub-Sections" are not included, as we don't have any of those yet (and may not).