Address review comments

Author: j08lue

_quarto.yml

@@ -40,84 +40,84 @@ website:
             - veda-project/target-use-cases/data-services.qmd
             - veda-project/target-use-cases/scientific-computing.qmd
       - text: "---"
-      - section: users-guide/index.qmd
+      - section: user-guide/index.qmd
         contents:
-          - section: users-guide/content-curation/index.qmd
+          - section: user-guide/content-curation/index.qmd
             contents:
-              - section: users-guide/content-curation/dataset-ingestion/index.qmd
+              - section: user-guide/content-curation/dataset-ingestion/index.qmd
                 contents:
-                  - users-guide/content-curation/dataset-ingestion/file-preparation.qmd
-                  - users-guide/content-curation/dataset-ingestion/catalog-ingestion.qmd
-                  - users-guide/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:
-                      - users-guide/content-curation/dataset-ingestion/stac-collection-conventions.qmd
-                      - users-guide/notebooks/veda-operations/stac-collection-creation.ipynb
-                      - users-guide/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:
-                      - users-guide/content-curation/dataset-ingestion/stac-item-conventions.qmd
-                      - users-guide/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:
-                      - users-guide/content-curation/dataset-ingestion/example-template/example-geoglam-ingest.ipynb
-              - section: users-guide/content-curation/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:
-                  - users-guide/content-curation/dashboard-configuration/dataset-configuration.qmd
-                  - users-guide/content-curation/dashboard-configuration/story-configuration.qmd
-              - section: users-guide/content-curation/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:
-                  - users-guide/notebooks/templates/template-accessing-the-data-directly.ipynb
-                  - users-guide/notebooks/templates/template-using-the-raster-api.ipynb
-                  - section: users-guide/data-services/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:
-              - users-guide/data-services/data-store.qmd
-              - users-guide/data-services/data-ingestion.qmd
-              - section: users-guide/data-services/apis/index.qmd
+              - user-guide/data-services/data-store.qmd
+              - user-guide/data-services/data-ingestion.qmd
+              - section: user-guide/data-services/apis/index.qmd
                 contents:
-                  - users-guide/data-services/apis/raster-api.qmd
-                  - users-guide/data-services/apis/stac-api.qmd
-          - section: users-guide/scientific-computing/index.qmd
+                  - user-guide/data-services/apis/raster-api.qmd
+                  - user-guide/data-services/apis/stac-api.qmd
+          - section: user-guide/scientific-computing/index.qmd
             contents:
-              - users-guide/scientific-computing/code-server.md
-              - users-guide/scientific-computing/ssh.md
-              - users-guide/scientific-computing/github-authentication.qmd
-              - users-guide/scientific-computing/custom-environments.qmd
-              - users-guide/scientific-computing/getting-access.qmd
-          - section: users-guide/notebooks/index.qmd
+              - 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:
-                      - users-guide/notebooks/quickstarts/list-collections.ipynb
-                      - users-guide/notebooks/quickstarts/open-and-plot.ipynb
-                      - users-guide/notebooks/quickstarts/timeseries-rioxarray-stackstac.ipynb
-                      - users-guide/notebooks/quickstarts/visualize-zarr.ipynb
-                      - users-guide/notebooks/quickstarts/visualize-multiple-times.ipynb
-                      - users-guide/notebooks/quickstarts/downsample-zarr.ipynb
-                      - users-guide/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:
-                      - users-guide/notebooks/quickstarts/no2-map-plot.ipynb
-                      - users-guide/notebooks/quickstarts/timeseries-stac-api.ipynb
-                      - users-guide/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:
-                  - users-guide/notebooks/tutorials/gif-generation.ipynb
-                  - users-guide/notebooks/tutorials/netcdf-to-cog-cmip6.ipynb
-                  - users-guide/notebooks/tutorials/mapping-fires.ipynb
-                  - users-guide/notebooks/tutorials/stac_ipyleaflet.ipynb
-                  - users-guide/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:
-                  - users-guide/notebooks/datasets/ocean-npp-timeseries-analysis.ipynb
-                  - users-guide/notebooks/datasets/nceo-biomass-statistics.ipynb
-                  - users-guide/notebooks/datasets/volcano-so2-monitoring.ipynb
-                  - users-guide/notebooks/datasets/air-quality-covid.ipynb
-                  - users-guide/notebooks/datasets/nldas_time_series.ipynb
-                  - users-guide/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

@@ -21,12 +21,12 @@ These docs help you use the services provided by the NASA VEDA Platform and lear
 :::
 
 :::{#secondcol}
-### User's Guide
+### User Guide
 
-* [Content Curation](/users-guide/content-curation/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](/users-guide/notebooks/index.qmd)
-* [Scientific Computing](/users-guide/scientific-computing/index.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/)
 :::
 
@@ -42,10 +42,10 @@ These docs help you use the services provided by the NASA VEDA Platform and lear
 
 ## New to VEDA?
 
-To learn from examples, see the [VEDA Example Notebooks](/users-guide/notebooks/index.qmd) - examples of open-source data science using VEDA services.
+To learn from examples, see the [VEDA Example Notebooks](/user-guide/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](/users-guide/scientific-computing/index.qmd).
+Selected user groups can also get access to a VEDA-provided [JupyterHub service](/user-guide/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.
 
-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](/users-guide/content-curation/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).

open-source-ecosystem/index.qmd

@@ -1,6 +1,6 @@
 ---
 title: VEDA Open Source Ecosystem
-subtitle: Proliferating open standards for science data platforms
+subtitle: Promoting open standards for science data platforms
 ---
 
 ## The Ecosystem

users-guide/content-curation/dashboard-configuration/dataset-configuration.qmd user-guide/content-curation/dashboard-configuration/dataset-configuration.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/users-guide/content-curation/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.
 

users-guide/content-curation/dashboard-configuration/index.qmd user-guide/content-curation/dashboard-configuration/index.qmd

@@ -36,5 +36,5 @@ Stuck on how to develop compliant metadata records for your dataset?
 
 Checkout the following notebooks and resources to help provide you with the STAC metadata required to [create the dataset definitions needed for catalog ingestion](https://nasa-impact.github.io/veda-docs/content-curation/dataset-ingestion/catalog-ingestion.html).
 
-- **How to create STAC Collections**: see this [example notebook](/users-guide/notebooks/veda-operations/stac-collection-creation.html) and related STAC [conventions](./stac-collection-conventions.qmd) 
-- **How to create STAC Items**:  see this [example notebook](/users-guide/notebooks/veda-operations/stac-item-creation.html) and [conventions](./stac-item-conventions.qmd).
+- **How to create STAC Collections**: see this [example notebook](/user-guide/notebooks/veda-operations/stac-collection-creation.html) and related STAC [conventions](./stac-collection-conventions.qmd) 
+- **How to create STAC Items**:  see this [example notebook](/user-guide/notebooks/veda-operations/stac-item-creation.html) and [conventions](./stac-item-conventions.qmd).

users-guide/content-curation/dashboard-configuration/story-configuration.qmd user-guide/content-curation/dashboard-configuration/story-configuration.qmd

@@ -16,9 +16,9 @@ Please note that this documentation site is rendered using [Quarto](https://quar
 
 There are two template notebooks in this section that you can use as a starting place. Alternatively you can pull specific cells from that notebook into your own.
 
- * [Using the raster API: `template-using-the-raster-api.ipynb`](/users-guide/notebooks/templates/template-using-the-raster-api.ipynb)
+ * [Using the raster API: `template-using-the-raster-api.ipynb`](/user-guide/notebooks/templates/template-using-the-raster-api.ipynb)
 
- * [Accessing the data directly: `template-accessing-the-data-directly.ipynb`](/users-guide/notebooks/templates/template-accessing-the-data-directly.ipynb)
+ * [Accessing the data directly: `template-accessing-the-data-directly.ipynb`](/user-guide/notebooks/templates/template-accessing-the-data-directly.ipynb)
 
 
 ### Style
@@ -67,7 +67,7 @@ Something like: public.ecr.aws/nasa-veda/pangeo-notebook:60b023fba2ca5f9e19d285c
 
 To give the notebooks a standard look and feel we typically include the following sections:
 
-- **Run this Notebook**: The section explains how to run the notebook locally, on [VEDA JupyterHub](https://docs.openveda.cloud/users-guide/scientific-computing/), on [VEDA Trial Hub](https://binder.openveda.cloud/), or on the public [MyBinder](https://mybinder.org/). There are several examples of what this section can look like in the template notebooks.
+- **Run this Notebook**: The section explains how to run the notebook locally, on [VEDA JupyterHub](https://docs.openveda.cloud/user-guide/scientific-computing/), on [VEDA Trial Hub](https://binder.openveda.cloud/), or on the public [MyBinder](https://mybinder.org/). There are several examples of what this section can look like in the template notebooks.
 - **Approach**: List a few steps that outline the approach you be taking in this notebook.
 - **About the data**: Optional description of the dataset
 - **Declare your collection of interest**: This section reiterates how you can discover which collections are available. You can copy the example of this section from one of the template notebooks.
@@ -104,7 +104,7 @@ To present consistent best practices, we always access data via the STAC API.
 
 ### Generate "Launch in VEDA JupyterHub" link
 
-We use [`nbgitpuller`](https://hub.jupyter.org/nbgitpuller/) links to open the VEDA JupyterHub with a particular notebook pulled in. These links have the form: `https://hub.openveda.cloud/hub/user-redirect/git-pull?repo=https://github.com/NASA-IMPACT/veda-docs&urlpath=lab/tree/veda-docs/users-guide/notebooks/quickstarts/open-and-plot.ipynb&branch=main`
+We use [`nbgitpuller`](https://hub.jupyter.org/nbgitpuller/) links to open the VEDA JupyterHub with a particular notebook pulled in. These links have the form: `https://hub.openveda.cloud/hub/user-redirect/git-pull?repo=https://github.com/NASA-IMPACT/veda-docs&urlpath=lab/tree/veda-docs/user-guide/notebooks/quickstarts/open-and-plot.ipynb&branch=main`
 
 If you are writing a notebook and want to share it with others you can generate your own `nbgitpuller` link using this
 [link generator](https://hub.jupyter.org/nbgitpuller/link?hub=https://hub.openveda.cloud&repo=https://github.com/NASA-impact/veda-docs&branch=main&app=jupyterlab).

users-guide/content-curation/dataset-ingestion/catalog-ingestion.qmd user-guide/content-curation/dataset-ingestion/catalog-ingestion.qmd

@@ -37,7 +37,7 @@ VEDA tilers are being upgraded to titiler-pgstac v1 which better aligns with the
 * STAC API (metadata): [staging.openveda.cloud/api/stac/docs](https://staging.openveda.cloud/api/stac/docs)
 * List collections: [staging.openveda.cloud/api/stac/collections](https://staging.openveda.cloud/api/stac/collections)
 * Raster API (map tiles and timeseries): [staging.openveda.cloud/api/raster/docs](https://staging.openveda.cloud/api/raster/docs)
-* Features API (vector data): [firenrt.delta-backend.com](https://firenrt.delta-backend.com) - see also the [usage tutorial](../users-guide/notebooks/tutorials/mapping-fires.html)
+* Features API (vector data): [firenrt.delta-backend.com](https://firenrt.delta-backend.com) - see also the [usage tutorial](../user-guide/notebooks/tutorials/mapping-fires.html)
 * Workflows API (request airflow ingestions): [staging.openveda.cloud/api/workflows/docs](https://staging.openveda.cloud/api/workflows/docs)
 * STAC viewer (experimental): [staging.openveda.cloud/api/stac/index.html](https://staging.openveda.cloud/api/stac/index.html)
 
@@ -63,8 +63,8 @@ That is because, unfortunately, neither XYZ nor WMTS have time series capabiliti
 
 You can see how to retrieve time steps and tile layer URLs from these tutorial Python notebooks (mostly REST API calls):
 
-1. [Using /stac/tilejson.json with STAC collection and item IDs](/users-guide/notebooks/datasets/ocean-npp-timeseries-analysis.html#visualizing-the-raster-imagery)
-2. [Creating layers from filters and mosaics (advanced)](/users-guide/notebooks/quickstarts/hls-visualization.html)
+1. [Using /stac/tilejson.json with STAC collection and item IDs](/user-guide/notebooks/datasets/ocean-npp-timeseries-analysis.html#visualizing-the-raster-imagery)
+2. [Creating layers from filters and mosaics (advanced)](/user-guide/notebooks/quickstarts/hls-visualization.html)
 
 It comes down to querying for STAC items (timesteps) and then asking the Raster API for `tilejson.json` specifications for the items you are interested in.
 

users-guide/content-curation/dataset-ingestion/example-template/CropMonitor_2023_06_28.tif user-guide/content-curation/dataset-ingestion/example-template/CropMonitor_2023_06_28.tif

@@ -15,5 +15,5 @@ VEDA's data ingestion services are designed to handle and manage the flow of dat
 
 2. **Ingest APIs**
    - The Ingest API facilitates data ingestion from multiple sources and manages the data flow into VEDA's system. This API is included in [veda-backend](https://github.com/NASA-IMPACT/veda-backend)
-   - To learn how to interact with these APIs as a user, consult the [Dataset Ingestion Guide](/users-guide/content-curation/dataset-ingestion/index.qmd).
+   - To learn how to interact with these APIs as a user, consult the [Dataset Ingestion Guide](/user-guide/content-curation/dataset-ingestion/index.qmd).
 

users-guide/content-curation/dataset-ingestion/example-template/example-geoglam-ingest.ipynb user-guide/content-curation/dataset-ingestion/example-template/example-geoglam-ingest.ipynb

@@ -24,4 +24,4 @@ The main public interface is the [STAC browser](https://openveda.cloud/?.languag
 
 The process of data ingestion into the VEDA Data Store is under active development.
 
-Please see our docs on [dataset ingestion](/users-guide/content-curation/dataset-ingestion/index.qmd).
+Please see our docs on [dataset ingestion](/user-guide/content-curation/dataset-ingestion/index.qmd).

users-guide/content-curation/dataset-ingestion/file-preparation.qmd user-guide/content-curation/dataset-ingestion/file-preparation.qmd

@@ -1,5 +1,5 @@
 ---
-title: Use's Guide
+title: User Guide
 subtitle: Resources for users and content contributors
 ---