fix: remove and do not reference out-of-date pages

user-guide/docs/css/ds-docs.css

@@ -24,7 +24,7 @@
 /* To also support underlining headings in hovered card for `.h1` et cetera */
 /* https://github.com/DesignSafe-CI/DS-User-Guide/blob/df64c11/user-guide/docs/usecases/overview.md?plain=1#L34-L37 */
 /* https://github.com/TACC/Core-Styles/blob/v2.27.0/src/lib/_imports/components/c-card--docs.css#L23-L29 */
-[class*=card--]:hover :is( .h1, .h2, .h3, .h4, .h5, .h6 ) {
+a[class*=card--]:hover :is( .h1, .h2, .h3, .h4, .h5, .h6 ) {
     text-decoration-line: underline;
     text-decoration-style: solid;
     text-decoration-thickness: var(--global-border-width--normal);

user-guide/docs/usecases/README.md

@@ -187,49 +187,58 @@ After a minute or so a preview deployment of your use case will be available on
 
 </details>
 
-### <a id="add-to-guide"></a> 12. Add Use Case New to User Guide
-
-If you have added a Use Case, include it into one of the existing use case category documents —
-
-| Category | Document |
-| - | - |
-| API | [`apiusecases.md`](./apiusecases.md) |
-| Data Analytics | [`dataanalyticsusecases.md`](./dataanalyticsusecases.md) |
-| Geohazard | [`geohazardusecases.md`](./geohazardusecases.md) |
-| Seismic | [`seismicusecases.md`](./seismicusecases.md) |
-| Wind and Storm Surge | [`windstormsurgeusecases.md`](./windstormsurgeusecases.md) |
+### <a id="add-to-guide"></a> 12. Add New Use Case to User Guide
+
+If you have added a Use Case, add it to the [`nav` in `user-guide/mkdocs.yml`](https://github.com/DesignSafe-CI/DS-User-Guide/blob/v2.2.0/user-guide/mkdocs.yml#L112-L136) —
+
+```yml
+  - Use Cases:
+    - Overview: usecases/overview.md
+    - Data Analytics:
+      - Multi-Data Set Image Analysis in Taggit: usecases/haan/usecase-3.md
+      - ...
+    - GeoHazard:
+      - NGL Database: usecases/brandenberg-ngl/usecase.md
+      - ...
+    - Seismic: 
+      - Seismic Response of Concrete Walls: usecases/lowes/usecase.md
+      - ...
+    - Wind and Storm Surge: 
+      - Field Sensing Wind Events: usecases/pinelli/usecase.md
+      - ...
+```
 
 — so that it will show up on this User Guide.
 
 #### Example
 
-To add to [`dataanalyticsusecases.md` (Data Analytics)](./dataanalyticsusecases.md):
-
-1. Find bottommost `{% include-markdown '…' %}` e.g.
-
-    ```md
-
-    ---
-
-    <!-- ## Visualization of spatially distributed data -->
-
-    {% include-markdown 'padgett/usecase_JN_viz.md' %}
+To add your use case to "Wind & Storm Surge":
+
+1. Open [`/user-guide/mkdocs.yml`](../../mkdocs.yml).
+2. Find the `nav` "Use Cases" hierarchy within "Wind & Storm Surge" category in "Use Cases":
+    ```yaml
+    nav:
+      - ...
+      - Use Cases:
+        - Overview: ...
+        - Data Analytics:
+          - ...
+        - GeoHazard:
+          - ...
+        - Seismic:
+          - ...
+        - Wind and Storm Surge: 
+          - ...
     ```
+2. Add an entry for your use case within "Wind & Storm Surge" category in "Use Cases":
 
-    <sup>Bottommost include may be different since last update.</sup>
-
-2. Add an include to your document in the same way:
-
-    ```md
-
-    ---
-
-    <!-- ## Description of yur use case -->
-
-    {% include-markdown 'your-usecase/usecase.md' %}
+    ```diff
+        - Wind and Storm Surge: 
+        - ...
+    +      - Your Use Case: your-usecase/usecase.md
     ```
 
-    <sup>Edit this include to point to your use case.</sup>
+    <sup>Edit the new line to reflect your use case.</sup>
 
 [DS-User-Guide]: https://github.com/DesignSafe-CI/DS-User-Guide/
 [DS_Use_Case_template]: https://github.com/DesignSafe-CI/DS_Use_Case_template/

user-guide/docs/usecases/overview.md

@@ -11,7 +11,7 @@ To help users fully embrace DesignSafe functionalities, we have developed a suit
 Make sure you are logged into DesignSafe so that you can access the Use-Case products.
 
 /////
-///// html | a.card--plain.card--image-top[href="../dataanalyticsusecases/"]
+///// html | article.card--plain.card--image-top
      markdown: block
 
 ////// html | img[alt="a data-driven map in a software interface"][src="./img/data.png"]
@@ -22,7 +22,7 @@ Make sure you are logged into DesignSafe so that you can access the Use-Case pro
 Analyze data from multiple datasets, with A.I. and Machine Learning, or via APIs or visualization.
 
 /////
-///// html | a.card--plain.card--image-top[href="../geohazardusecases/"]
+///// html | article.card--plain.card--image-top
      markdown: block
 
 ////// html | img[alt="a color-coded landslide"][src="./img/geo.png"]
@@ -33,7 +33,7 @@ Analyze data from multiple datasets, with A.I. and Machine Learning, or via APIs
 Geological hazard use cases like liquefaction and landslide modeling.
 
 /////
-///// html | a.card--plain.card--image-top[href="../seismicusecases/"]
+///// html | article.card--plain.card--image-top
      markdown: block
 
 ////// html | img[alt="a grid of two kinds of diagonal marks over 4 columns"][src="./img/seismic.jpg"]
@@ -44,7 +44,7 @@ Geological hazard use cases like liquefaction and landslide modeling.
 Analyze seismic responses, soil structure interaction, and shake tables. Integrate with OpenSees.
 
 /////
-///// html | a.card--plain.card--image-top[href="../windstormsurgeusecases/"]
+///// html | article.card--plain.card--image-top
      markdown: block
 
 ////// html | img[alt="a triangular mesh over shallow water area of a coastal map"][src="./img/wind.png"]

user-guide/mkdocs.yml

@@ -107,20 +107,10 @@ nav:
 #        - 4. Jupyter & HPC: tools/simulation/opensees/openseesRunJupyterHPC.md
 #        - 5. TACC: tools/simulation/opensees/openseesRunTACC.md
 
-  # - Use Cases Flat:
-  #   - Overview: usecases/overview.md
-  #   - Data Analytics: usecases/dataanalyticsusecases.md
-  #   - GeoHazard: usecases/geohazardusecases.md
-  #   - Seismic: usecases/seismicusecases.md
-  #   - Wind and Storm Surge: usecases/windstormsurgeusecases.md
-
 
   - Use Cases:
     - Overview: usecases/overview.md
     - Data Analytics:
-# the following have been moved to the user guide. we need to remove these files from the directory in use cases, but doing so would break `{% include-markdown '../usecases/haan/usecase` in `user-guide/docs/tools/visualization.md`
-#      - Basic Image Browsing and Mapping: usecases/haan/usecase.md
-#      - Grouping and Tagging Image Files: usecases/haan/usecase-2.md
       - Multi-Data Set Image Analysis in Taggit: usecases/haan/usecase-3.md
       - ML and AI: usecases/vantassel_and_zhang/usecase.md
       - Application Programming Interfaces: usecases/brandenberg-api/usecase.md