Adding beginner friendly explanations on the Docs

docs/getting-started/freq-asked-questions.rst

@@ -4,6 +4,19 @@
 Frequently Asked Questions
 ==========================
 
+I want to learn more about UXarray (or other geospatial topics), where should I start?
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+We have extensive notebooks, tutorials, and learning resources on our site Project Pythia:
+`Project Pythia Cookbooks <https://cookbooks.projectpythia.org/>`_ have a variety of domain specific workflows to learn from.
+If you want more UXarray specific information and examples, look at our `Unstructured Grid Visualization Cookbook <https://projectpythia.org/unstructured-grid-viz-cookbook/>`_
+where we have:
+
+- `Unstructured Grids Overview <https://projectpythia.org/unstructured-grid-viz-cookbook/notebooks/foundations/unstructured-grids/>`_
+- `Plotting Libraries and Live Demos <https://projectpythia.org/unstructured-grid-viz-cookbook/notebooks/foundations/plotting-libs/>`_
+- `Comparison to Xarray <https://projectpythia.org/unstructured-grid-viz-cookbook/notebooks/plotting-with-uxarray/compare-xarray/>`_
+
+And other useful guides!
+
 What foundational assumptions does UXarray make about grids and geometry?
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 UXarray assumes horizontally unstructured grids, consistent with the

docs/getting-started/overview.rst

@@ -13,6 +13,10 @@ used formats such as UGRID, SCRIP, and Exodus. Furthermore, UXarray provides bas
 for generating unstructured grid topology from structured grid or point-cloud inputs to
 enable model intercomparison workflows.
 
+.. note::
+  For new users interested in learning from our documented coding examples, notebooks, geospatial
+  lessons, and more, check out `Project Pythia <https://projectpythia.org/unstructured-grid-viz-cookbook>`_
+  where additional documentation can be found.
 
 Unstructured Grids
 ==================

docs/tutorials.rst

@@ -7,4 +7,6 @@ Tutorials & Videos
 
 Tutorials
 ---------
-* `Project Pythia Unstructured Grid Visualization Cookbook <https://projectpythia.org/unstructured-grid-viz-cookbook>`_
+* `Project Pythia Unstructured Grid Visualization Cookbook <https://projectpythia.org/unstructured-grid-viz-cookbook>`_ - A series of guides in the form of Jupyter notebooks. Shows code, examples, visualizations for various uses of ``uxarray``.
+* `UXarray Tutorial at ESDS 2024 <https://www.youtube.com/watch?v=sOCMSLZrwQs>`_ - A YouTube video presentation by one of the lead UXarray developers on the motivation of UXarray, its origins, and uses.
+* `UXarray Presentation at SciPy 2023 <https://www.youtube.com/watch?v=qwqJeOO8m6A>`_ - A second YouTube video presentation by another one of the lead UXarray developers on UXarray at SciPy 2023.

docs/user-guide/data-structures.ipynb

@@ -24,8 +24,8 @@
     "The core functionality of UXarray revolves around three data structures, which are used for interacting with unstructured grids and the data variables that reside on them.\n",
     "\n",
     "1. **[`uxarray.Grid`](https://uxarray.readthedocs.io/en/latest/generated/uxarray.UxDataArray.html)**: Stores the grid representation (i.e. coordinates, connectivity information, etc.)\n",
-    "2. **[`uxarray.UxDataset`](https://uxarray.readthedocs.io/en/latest/api.html#uxdataset)**: One or more data variable that resided on a grid.\n",
-    "3. **[`uxarray.UxDataArray`](https://uxarray.readthedocs.io/en/latest/api.html#uxdataarray)**: A single data variable that resides on a grid\n"
+    "2. **[`uxarray.UxDataset`](https://uxarray.readthedocs.io/en/latest/api.html#uxdataset)**: One or more data variables that reside on a grid. Each variable is stored in a UxDataArray.\n",
+    "3. **[`uxarray.UxDataArray`](https://uxarray.readthedocs.io/en/latest/api.html#uxdataarray)**: A single data variable that resides on a grid.\n"
    ]
   },
   {
@@ -486,7 +486,10 @@
     }
    },
    "outputs": [],
-   "source": "uxds = ux.open_dataset(grid_path, data_path)\nuxds"
+   "source": [
+    "uxds = ux.open_dataset(grid_path, data_path)\n",
+    "uxds"
+   ]
   },
   {
    "cell_type": "markdown",

docs/user-guide/grid-formats.rst

@@ -256,13 +256,13 @@ Coordinates
 
    <style>
    .yes-cell {
-     background-color: green;
+     background-color: #6aa84f; /* Light green color */
      color: white;
      text-align: center;
    }
 
    .no-cell {
-     background-color: red;
+     background-color: #e06666; /* Light red color */
      color: white;
      text-align: center;
    }
@@ -356,13 +356,13 @@ Connectivity
 
    <style>
    .yes-cell {
-     background-color: green;
+     background-color: #6aa84f; /* Light green color */
      color: white;
      text-align: center;
    }
 
    .no-cell {
-     background-color: red;
+     background-color: #e06666; /* Light red color */
      color: white;
      text-align: center;
    }

docs/userguide.rst

@@ -32,7 +32,7 @@ These user guides provide detailed explanations of the core functionality in UXa
  Core data structures for working with unstructured grid and data files
 
 `Custom Grid Topology <user-guide/custom-grid.ipynb>`_
- Create a Grid from custom Grid topology and convert existing Xarray data structures to UXarray.
+ Create a Grid from custom Grid topology and convert existing Xarray data structures to UXarray
 
 `Loading Data using Dask <user-guide/parallel-load-ux-with-dask.ipynb>`_
  Read data with chunking and/or in parallel
@@ -50,7 +50,7 @@ These user guides provide detailed explanations of the core functionality in UXa
  Select specific regions of a grid
 
 `Spatial Hashing <user-guide/spatial-hashing.ipynb>`_
- Use spatial hashing to locate the faces a list of points reside in.
+ Use spatial hashing to locate the faces a list of points reside in
 
 `Cross-Sections <user-guide/cross-sections.ipynb>`_
  Select cross-sections of a grid