Adding beginner friendly explanations on the Docs

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

@@ -4,6 +4,20 @@
 Frequently Asked Questions
 ==========================
 
+I want to learn more about unstructured grids (or other topics of the Earth System Sciences), where should I start?
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Check out:
+`Project Pythia <https://cookbooks.projectpythia.org/>`_ , a home for Python-justified learning resources that are open-source, community-owned, geoscience-focused, and high-quality. For instance,
+`Pythia Cookbooks <https://cookbooks.projectpythia.org/>`_ provide a variety of advanced, domain-specific workflows. In particular, the
+`Unstructured Grid Visualization Cookbook <https://projectpythia.org/unstructured-grid-viz-cookbook/>`_ houses
+`foundational information <https://projectpythia.org/unstructured-grid-viz-cookbook/notebooks/foundations/unstructured-grids/>`_ along with a comprehensive
+showcase of workflows & techniques for working with Unstructured Grids.
+
+
+Read through `UGRID Conventions <https://ugrid-conventions.github.io/ugrid-conventions/>`_, which is what UXarray is written around to represent several
+different unstructured mesh types in a unified, `Climate and Forecast metadata convention (CF) <https://cfconventions.org/>`_-compliant format.
+
+
 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,9 @@ 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 who are looking to learn more about unstructured grids (or other topics of the Earth System Sciences),
+  check out our `Frequently Asked Questions <https://uxarray.readthedocs.io/en/latest/getting-started/freq-asked-questions.html>`_.
 
 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