Merge pull request #203 from NASA-IMPACT/feat/sections-refactor

Re-establish three sections

Author: j08lue

.github/pull_request_template.md

@@ -15,7 +15,7 @@ Tutorial
 Dataset
 
 ## Checklist
-_The following checklist ensures that our notebooks are internally consistent ([read more](https://nasa-impact.github.io/veda-docs/adding-content/doc-and-notebooks))_
+_The following checklist ensures that our notebooks are internally consistent ([read more](https://nasa-impact.github.io/veda-docs/content-curation/doc-and-notebooks))_
 
 - [ ] The first cell contains the rendering information with author and data
 - [ ] The notebook has a **Run this Notebook** section (with filename in link)

_quarto.yml

@@ -29,92 +29,94 @@ website:
     contents:
       - href: index.qmd
         text: Welcome
-      - href: AGU2024.qmd
-        text: AGU 2024
       - text: "---"
-      - section: NASA VEDA Platform
+      - section: veda-project/index.qmd
         contents:
-          - nasa-veda-platform/about/index.qmd
-          - nasa-veda-platform/why/index.qmd
-          - nasa-veda-platform/dashboard/index.qmd
-          - section: nasa-veda-platform/data-services/index.qmd
+          - veda-project/why.qmd
+          - section: veda-project/target-use-cases/index.qmd
             contents:
-              - nasa-veda-platform/data-services/data-store.qmd
-              - nasa-veda-platform/data-services/data-ingestion.qmd
-              - section: nasa-veda-platform/data-services/apis/index.qmd
-                contents:
-                  - nasa-veda-platform/data-services/apis/raster-api.qmd
-                  - nasa-veda-platform/data-services/apis/stac-api.qmd
-          - section: nasa-veda-platform/scientific-computing/index.qmd
-            contents:
-              - nasa-veda-platform/scientific-computing/code-server.md
-              - nasa-veda-platform/scientific-computing/ssh.md
-              - nasa-veda-platform/scientific-computing/github-authentication.qmd
-              - nasa-veda-platform/scientific-computing/custom-environments.qmd
-              - nasa-veda-platform/scientific-computing/getting-access.qmd
+            - veda-project/target-use-cases/dashboard.qmd
+            - veda-project/target-use-cases/data-services.qmd
+            - veda-project/target-use-cases/scientific-computing.qmd
       - text: "---"
-      - section: instance-management/index.qmd
+      - section: user-guide/index.qmd
         contents:
-          - section: instance-management/adding-content/index.qmd
+          - section: user-guide/content-curation/index.qmd
             contents:
-              - section: instance-management/adding-content/dataset-ingestion/index.qmd
+              - section: user-guide/content-curation/dataset-ingestion/index.qmd
                 contents:
-                  - instance-management/adding-content/dataset-ingestion/file-preparation.qmd
-                  - instance-management/adding-content/dataset-ingestion/catalog-ingestion.qmd
-                  - notebooks/veda-operations/generate-cmip6-kerchunk-historical.ipynb
+                  - user-guide/content-curation/dataset-ingestion/file-preparation.qmd
+                  - user-guide/content-curation/dataset-ingestion/catalog-ingestion.qmd
+                  - user-guide/notebooks/veda-operations/generate-cmip6-kerchunk-historical.ipynb
                   - section: STAC Collection Creation
                     contents:
-                      - instance-management/adding-content/dataset-ingestion/stac-collection-conventions.qmd
-                      - notebooks/veda-operations/stac-collection-creation.ipynb
-                      - notebooks/veda-operations/publish-cmip6-kerchunk-stac.ipynb
+                      - user-guide/content-curation/dataset-ingestion/stac-collection-conventions.qmd
+                      - user-guide/notebooks/veda-operations/stac-collection-creation.ipynb
+                      - user-guide/notebooks/veda-operations/publish-cmip6-kerchunk-stac.ipynb
                   - section: STAC Item Creation
                     contents:
-                      - nasa-veda-platform/adding-content/dataset-ingestion/stac-item-conventions.qmd
-                      - notebooks/veda-operations/stac-item-creation.ipynb
+                      - user-guide/content-curation/dataset-ingestion/stac-item-conventions.qmd
+                      - user-guide/notebooks/veda-operations/stac-item-creation.ipynb
                   - section: Boilerplate ingest example
                     contents:
-                      - instance-management/adding-content/dataset-ingestion/example-template/example-geoglam-ingest.ipynb
-              - section: instance-management/adding-content/dashboard-configuration/index.qmd
+                      - user-guide/content-curation/dataset-ingestion/example-template/example-geoglam-ingest.ipynb
+              - section: user-guide/content-curation/dashboard-configuration/index.qmd
                 contents:
-                  - instance-management/adding-content/dashboard-configuration/dataset-configuration.qmd
-                  - instance-management/adding-content/dashboard-configuration/story-configuration.qmd
-              - section: instance-management/adding-content/docs-and-notebooks.qmd
+                  - user-guide/content-curation/dashboard-configuration/dataset-configuration.qmd
+                  - user-guide/content-curation/dashboard-configuration/story-configuration.qmd
+              - section: user-guide/content-curation/docs-and-notebooks.qmd
                 contents:
-                  - notebooks/templates/template-accessing-the-data-directly.ipynb
-                  - notebooks/templates/template-using-the-raster-api.ipynb
-          - section: notebooks/index.qmd
+                  - user-guide/notebooks/templates/template-accessing-the-data-directly.ipynb
+                  - user-guide/notebooks/templates/template-using-the-raster-api.ipynb
+                  - section: user-guide/data-services/index.qmd
+          - section: Data Access and Data Management
+            contents:
+              - user-guide/data-services/data-store.qmd
+              - user-guide/data-services/data-ingestion.qmd
+              - section: user-guide/data-services/apis/index.qmd
+                contents:
+                  - user-guide/data-services/apis/raster-api.qmd
+                  - user-guide/data-services/apis/stac-api.qmd
+          - section: user-guide/scientific-computing/index.qmd
+            contents:
+              - user-guide/scientific-computing/code-server.md
+              - user-guide/scientific-computing/ssh.md
+              - user-guide/scientific-computing/github-authentication.qmd
+              - user-guide/scientific-computing/custom-environments.qmd
+              - user-guide/scientific-computing/getting-access.qmd
+          - section: user-guide/notebooks/index.qmd
             contents:
               - section: Quickstarts
                 contents:
                   - section: Accessing the Data Directly
                     contents:
-                      - notebooks/quickstarts/list-collections.ipynb
-                      - notebooks/quickstarts/open-and-plot.ipynb
-                      - notebooks/quickstarts/timeseries-rioxarray-stackstac.ipynb
-                      - notebooks/quickstarts/visualize-zarr.ipynb
-                      - notebooks/quickstarts/visualize-multiple-times.ipynb
-                      - notebooks/quickstarts/downsample-zarr.ipynb
-                      - notebooks/quickstarts/download-assets.ipynb
+                      - user-guide/notebooks/quickstarts/list-collections.ipynb
+                      - user-guide/notebooks/quickstarts/open-and-plot.ipynb
+                      - user-guide/notebooks/quickstarts/timeseries-rioxarray-stackstac.ipynb
+                      - user-guide/notebooks/quickstarts/visualize-zarr.ipynb
+                      - user-guide/notebooks/quickstarts/visualize-multiple-times.ipynb
+                      - user-guide/notebooks/quickstarts/downsample-zarr.ipynb
+                      - user-guide/notebooks/quickstarts/download-assets.ipynb
                   - section: Using the Raster API
                     contents:
-                      - notebooks/quickstarts/no2-map-plot.ipynb
-                      - notebooks/quickstarts/timeseries-stac-api.ipynb
-                      - notebooks/quickstarts/hls-visualization.ipynb
+                      - user-guide/notebooks/quickstarts/no2-map-plot.ipynb
+                      - user-guide/notebooks/quickstarts/timeseries-stac-api.ipynb
+                      - user-guide/notebooks/quickstarts/hls-visualization.ipynb
               - section: Tutorials
                 contents:
-                  - notebooks/tutorials/gif-generation.ipynb
-                  - notebooks/tutorials/netcdf-to-cog-cmip6.ipynb
-                  - notebooks/tutorials/mapping-fires.ipynb
-                  - notebooks/tutorials/stac_ipyleaflet.ipynb
-                  - notebooks/tutorials/zonal-statistics-validation.ipynb
+                  - user-guide/notebooks/tutorials/gif-generation.ipynb
+                  - user-guide/notebooks/tutorials/netcdf-to-cog-cmip6.ipynb
+                  - user-guide/notebooks/tutorials/mapping-fires.ipynb
+                  - user-guide/notebooks/tutorials/stac_ipyleaflet.ipynb
+                  - user-guide/notebooks/tutorials/zonal-statistics-validation.ipynb
               - section: Datasets
                 contents:
-                  - notebooks/datasets/ocean-npp-timeseries-analysis.ipynb
-                  - notebooks/datasets/nceo-biomass-statistics.ipynb
-                  - notebooks/datasets/volcano-so2-monitoring.ipynb
-                  - notebooks/datasets/air-quality-covid.ipynb
-                  - notebooks/datasets/nldas_time_series.ipynb
-                  - notebooks/datasets/nldas_compare2_3.ipynb
+                  - user-guide/notebooks/datasets/ocean-npp-timeseries-analysis.ipynb
+                  - user-guide/notebooks/datasets/nceo-biomass-statistics.ipynb
+                  - user-guide/notebooks/datasets/volcano-so2-monitoring.ipynb
+                  - user-guide/notebooks/datasets/air-quality-covid.ipynb
+                  - user-guide/notebooks/datasets/nldas_time_series.ipynb
+                  - user-guide/notebooks/datasets/nldas_compare2_3.ipynb
       - text: "---"
       - section: open-source-ecosystem/index.qmd
         contents:

index.qmd

@@ -13,25 +13,25 @@ These docs help you use the services provided by the NASA VEDA Platform and lear
 :::: {layout="[0.33, 0.33, 0.33]"}
 
 :::{#firstcol}
-### NASA VEDA Platform
+### Why and What
 
-* [About the VEDA Project](/nasa-veda-platform/about/index.qmd)
-* [Why use VEDA](/nasa-veda-platform/why/index.qmd)
-* [Data Access and Management Services](/nasa-veda-platform/data-services/index.qmd)
-* [VEDA Dashboard](/nasa-veda-platform/dashboard/index.qmd)
-* [Scientific Computing](/nasa-veda-platform/scientific-computing/index.qmd)
-* [Service Status](https://nasa-impact.github.io/veda-statuspage/)
+* [About the VEDA Project](/veda-project/index.qmd)
+* [Why Platforms?](/veda-project/why.qmd)
+* [Platform Components and Target Use Cases](/veda-project/target-use-cases/index.qmd)
 :::
 
 :::{#secondcol}
-### Managing Your Own VEDA
+### User Guide
 
-* [Adding Content](/instance-management/adding-content/index.qmd)
-* [Usage Examples and Tutorials](/notebooks/index.qmd)
+* [Content Curation](/user-guide/content-curation/index.qmd)
+* [Data Access and Management Services](/veda-project/target-use-cases/data-services.qmd)
+* [Usage Examples and Tutorials](/user-guide/notebooks/index.qmd)
+* [Scientific Computing](/user-guide/scientific-computing/index.qmd)
+* [Service Status](https://nasa-impact.github.io/veda-statuspage/)
 :::
 
 :::{#thirdcol}
-### VEDA Open-Source Ecosystem
+### Open-Source Ecosystem
 
 * [Software Architecture](/open-source-ecosystem/architecture.qmd)
 * [Repositiories](/open-source-ecosystem/repositories.qmd)
@@ -42,10 +42,10 @@ These docs help you use the services provided by the NASA VEDA Platform and lear
 
 ## New to VEDA?
 
-If you are just getting started with open-source geospatial data science (in Python) or want to learn more, you may find the [Collection of External Resources](/open-source-ecosystem/external-resources.qmd) useful.
+To learn from examples, see the [VEDA Example Notebooks](/user-guide/notebooks/index.qmd) - examples of open-source data science using VEDA services.
 
-To learn from examples, see the [VEDA Example Notebooks](/notebooks/index.qmd) - examples of open-source data science using VEDA services.
+Selected user groups can also get access to a VEDA-provided [JupyterHub service](/user-guide/scientific-computing/index.qmd).
 
-Selected user groups can also get access to a VEDA-provided [JupyterHub service](/nasa-veda-platform/scientific-computing/index.qmd).
+If you are just getting started with open-source geospatial data science (in Python) or want to learn more, you may find the [Collection of External Resources](/open-source-ecosystem/external-resources.qmd) useful.
 
-Contributions of data, stories, and example code are open to all users affiliated with the project. We strive to make the process as easy as possible. Please see the docs on [Adding Content](/instance-management/adding-content/index.qmd).
+Want to contribute data, stories, and example code to this site and the [VEDA Dashboard for NASA EarthData](https://www.earthdata.nasa.gov/dashboard/)? Please see the docs on [Content Curation](/user-guide/content-curation/index.qmd).

instance-management/index.qmd

@@ -1,10 +1,14 @@
 ---
-title: VEDA Open Source Ecosystem
-subtitle: A modular ecosystem of open source software for science data platforms
+title: The VEDA Open Source Ecosystem
+subtitle: Promoting open standards for science data platforms
 ---
 
-## In this section, you can find
+## The Ecosystem
 
-* An overview of the VEDA [software architecture](./architecture.qmd)
-* Links to our project's [code repositories of redeployable software components](./repositories.qmd)
-* A collection of [external resources for learning and reference](./external-resources.qmd)
+Below are resources for prospective platform providers and contributors to the open source ecosystem that VEDA leverages to provide science data platforms.
+
+* [Software architecture](./architecture.qmd)
+* [Code repositories of redeployable software components](./repositories.qmd)
+* [External resources for learning and reference](./external-resources.qmd)
+
+If you are interested in setting up your own platform based on VEDA open-source software, please email the VEDA team at [email protected] and we will provide further direction.

nasa-veda-platform/data-services/index.qmd

@@ -30,7 +30,7 @@ Scripts for data downloading, transformation, and related processing for the VED
 Dashboard UI for viewing and analysing VEDA assets
 
 ### [veda-config](https://github.com/NASA-IMPACT/veda-config)
-Configuration for viewing VEDA assets in dashboard UI
+Content for the [VEDA Dashboard for NASA EarthData](https://www.earthdata.nasa.gov/dashboard/) and template for other projects
 
 ## VEDA JupyterHub
 ### [2i2c-org/infrastructure](2i2c-org/infrastructure)

nasa-veda-platform/index.qmd

@@ -3,7 +3,7 @@ title: "Dataset Configuration"
 subtitle: "Configuring your VEDA Dashboard to show a Dataset already available in VEDA Data Services"
 ---
 
-Once a dataset is available in your VEDA STAC through VEDA Data Services (following the steps in the [Dataset Ingestion docs](https://docs.openveda.cloud/nasa-veda-platform/adding-content/dataset-ingestion/)), you will need to configure the Dashboard.
+Once a dataset is available in your VEDA STAC through VEDA Data Services (following the steps in the [Dataset Ingestion docs](https://docs.openveda.cloud/user-guide/content-curation/dataset-ingestion/)), you will need to configure the Dashboard.
 
 Please note that the VEDA Dashboard relies on its own set of metadata about datasets. No information from STAC is loaded initially, so some metadata may require copying information from the STAC records, such as title, description, and dataset providers.
 

open-source-ecosystem/index.qmd

@@ -3,7 +3,7 @@ title: "Dashboard Configuration"
 subtitle: "Dataset and story publication in your VEDA Dashboard"
 ---
 
-This guide explains how to publish content to your instance of the [VEDA Dashboard](https://www.earthdata.nasa.gov/dashboard/). You will do this in your own customized repository that resembles [veda-config](https://github.com/NASA-IMPACT/veda-config), the configuration repository for the [Earthdata VEDA Dashboard](https://www.earthdata.nasa.gov/dashboard/).
+This guide explains how to publish content to your instance of the VEDA Dashboard. You will do this in your own customized repository that resembles [veda-config](https://github.com/NASA-IMPACT/veda-config), the configuration repository for the [Earthdata VEDA Dashboard](https://www.earthdata.nasa.gov/dashboard/).
 
 Detailed technical documentation for each of the steps is available on GitHub and other places, links provided in the Appendix below.
 
@@ -46,7 +46,7 @@ For **Datasets**, the required content is:
 2. Short descriptions for each layer that you will want to reveal within VEDA (an example of this would be "CO2 mean vs CO2 difference") for users to explore on a map
 3. A cover image for the dataset as it will appear in the Dashboard
 4. Any other relevant metadata you might want included
-    https://nasa-impact.github.io/veda-docs/adding-content/dashboard-content.html
+    https://nasa-impact.github.io/veda-docs/content-curation/dashboard-content.html
 
 Next step: If your data is already in VEDA go to [Dataset Configuration](./dataset-configuration.qmd). Otherwise go to [Dataset Ingestion](../dataset-ingestion/index.qmd).