How to guide order (#172)

* order of howto guides in mkdocs.yml

* cards in how to guides and image processing

* add missing nav link to oleg's new mission data doc

* link spelling

Author: jrcain-usgs

docs/how-to-guides/image-processing/index.md

@@ -5,8 +5,13 @@
 <div class="grid cards" markdown>
 
 - [:material-filter-outline: Remove Striping and Noise :octicons-arrow-right-24:](general-utility-with-fx.md)
+
+    Raw images often have artifacts that should be removed before further processing.
+
 - [:material-plus-minus-variant: General Utility with FX :octicons-arrow-right-24:](general-utility-with-fx.md)
 
+    Perform general math or logic operations on the pixels of an image.
+
 </div>
 
 ## Image Projection
@@ -15,6 +20,8 @@
 
 - [:material-map: Map Projecting :octicons-arrow-right-24:](map-projecting-images.md)
 
+    Transform the geometry of an image to match a specific map-projection.
+
 </div>
 
 ## Spice
@@ -23,4 +30,6 @@
 
 - [:material-chart-bell-curve-cumulative: Bundle Adjustment in __ISIS__ :octicons-arrow-right-24:](bundle-adjustment-in-isis.md)
 
+    Line up images by finding their overlaps, and create a mosaic.
+
 </div>

docs/how-to-guides/index.md

@@ -1,23 +1,67 @@
 # How-To Guides
 
-How-to guides are much like recipes in a recipe book. Write how-to docs to solve specific problems quickly, sometimes copy-pastable. Think of how-to guides as preemptive StackOverflow-like problems.
+[comment]: <> (These cards are a good place to highlight specific docs with high value, or ones readers commonly want to see)
+
+<div class="grid cards" markdown>
+
+-   :octicons-download-24:{ .lg .middle } __Use our script to install ISIS__
+
+    ---
+
+    ```sh
+    bash <(curl https://raw.githubusercontent.com/DOI-USGS/ISIS3/refs/heads/dev/isis/scripts/install_isis.sh)
+    ```
+
+    [:octicons-arrow-right-24: More on Installing ISIS](../how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md)
+
+-   :material-data-matrix-edit:{ .lg .middle } __Image Processing__
+
+    ---
+
+    Manipulate pixels, remove noise, and align multiple images together.
+
+    [:octicons-arrow-right-24: Work on Images in ISIS](../how-to-guides/image-processing/index.md)
+
+-   :octicons-code-square-24:{ .lg .middle } __ISIS Development Guides__
 
+    ---
+
+    Learn how to build, write code for, and contribute to ISIS.
+
+    [:octicons-arrow-right-24: Develop in ISIS](../how-to-guides/isis-developer-guides/developing-isis3-with-cmake.md)
+
+-   :octicons-comment-discussion-24:{ .lg .middle } __I have an Issue!__
+
+    ---
+
+    Learn how to report issues with ISIS and how the maintainers respond to issues.
+
+    [:octicons-arrow-right-24: Report an Issue](../how-to-guides/software-management/guidelines-for-reporting-issues.md)
+
+</div>
+
+-----
+
+How-to guides are much like recipes in a recipe book. Write how-to docs to solve specific problems quickly, sometimes copy-pastable. Think of how-to guides as preemptive StackOverflow-like problems.
 
-## For Readers 
 [comment]: <> (This is a good place to mention any places for someone to start looking in. Highlight specific docs with high value or we identify readers commonly want to see)
 
-Use the table of contents on the left to start browsing guides. 
+Use the table of contents on the left to start browsing guides. Check out the above cards if you aren't sure where to start.  Use the search bar if you're looking for something specific.
+
+-----
 
-## For Authors
+??? quote "Want to write a how-to guide?"
 
-Before you start writing a new How-To guide. Make sure what you are writing belongs here. These are similar to getting-started guides, in that they explain to users how to perform some valuable tasks with the software, but distinct in that they:
+    When contributing documentation, consider what category it should should go in.  Docs in the **how-to guides** category should: 
 
-1. Solve practical problems for more experienced users
-1. Offer more ambiguous starting points; they should be reusable in many different contexts 
-1. Can be much shorter than getting-started docs. 
+    1. Solve practical problems for more experienced users
+    1. Offer more ambiguous starting points; they should be reusable in many different contexts 
+    1. Can be much shorter than getting-started docs
+    1. Some examples:
+        - How-to: generate an ISD via loads with specific kernels
+        - How-to: get GEOJSON from ISIS footprints
+        - Cookbook of common operations in a library
 
-??? Info Examples
-    * How-to: generate an ISD via loads with specific kernels
-    * How-to: get GEOJSON from ISIS footprints
-    * Cookbook of common operations in a library
+    On the other hand, docs in the **getting started** category detail specific tasks for users who may not have much experience; docs in the **concepts** category provide an understanding of a topic without necessarily going into detail on how to carry out specific tasks. 
+ 
 

mkdocs.yml

@@ -65,10 +65,11 @@ nav:
     - ISIS Environment Setup and Maintenance:
       - Installing ISIS:                   how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md
       - Setting up the ISIS Data Area:     how-to-guides/environment-setup-and-maintenance/isis-data-area.md
-      - Using ISIS in other Conda Envs:    how-to-guides/environment-setup-and-maintenance/using-isis-in-other-conda-envs.md
-      - Anaconda in a Network Environment: how-to-guides/environment-setup-and-maintenance/anaconda-in-a-network-environment.md
       - SPICE Kernel Updates in ISIS:      how-to-guides/environment-setup-and-maintenance/spice-kernel-updates-in-isis.md
+      - Setting Up ISIS Data for New Missions: how-to-guides/environment-setup-and-maintenance/setup-isis-data.md
       - Adding USGSCSM Plugin to ISIS:     how-to-guides/environment-setup-and-maintenance/adding-usgscsm-plugin-to-isis.md
+      - Using ISIS in other Conda Envs:    how-to-guides/environment-setup-and-maintenance/using-isis-in-other-conda-envs.md
+      - Anaconda in a Network Environment: how-to-guides/environment-setup-and-maintenance/anaconda-in-a-network-environment.md
     - SPICE: 
       - Creating Spice Config Files in SpiceQL: how-to-guides/SPICE/creating-spice-config-files-in-spiceql.md
       - Using SpiceQL with Other Libraries: how-to-guides/SPICE/using-spiceql-with-other-libraries.md
@@ -83,26 +84,25 @@ nav:
     - ISIS Demos:
       - Interactive Online Demos:          how-to-guides/demos/isis-demos.md
     - Software Management:
-      - Deprecation:                       how-to-guides/software-management/deprecation.md
-      - Software Support:                  how-to-guides/software-management/software-support.md
       - Guidelines for Reporting Issues:   how-to-guides/software-management/guidelines-for-reporting-issues.md
       - Guidelines for Pull Requests:      how-to-guides/software-management/guidelines-for-pull-requests.md
+      - Deprecation:                       how-to-guides/software-management/deprecation.md
+      - Software Support:                  how-to-guides/software-management/software-support.md
+    - Releases:                          
+      - Home:                            how-to-guides/software-management/releases/index.md
+      - Releasing ISIS:                   how-to-guides/software-management/releases/isis-release-process.md
+      - Releasing Other Astro Software:   how-to-guides/software-management/releases/general-release-process.md
       - ISIS Release Schedule:             how-to-guides/software-management/isis-release-schedule.md
-      - Releases:                          
-        - Home:                            how-to-guides/software-management/releases/index.md
-        - Releasing ISIS:                   how-to-guides/software-management/releases/isis-release-process.md
-        - Releasing Other Astro Software:   how-to-guides/software-management/releases/general-release-process.md
-        - ISIS Release Schedule:             how-to-guides/software-management/isis-release-schedule.md
-        - LTS Release Process:               how-to-guides/software-management/lts-release-process.md
+      - LTS Release Process:               how-to-guides/software-management/lts-release-process.md
     - ISIS Developer Guides:
+      - Developing ISIS3 with cmake:                  how-to-guides/isis-developer-guides/developing-isis3-with-cmake.md
+      - ISIS Development on ARM Macs:    how-to-guides/isis-developer-guides/developing-mac-m1-arm-systems.md
+      - ISIS Test Data:                               how-to-guides/isis-developer-guides/obtaining-maintaining-submitting-test-data.md
       - Contributing to ISIS:                         how-to-guides/isis-developer-guides/contributing-to-isis.md
+      - Building and Contributing to ISIS Tutorial:   how-to-guides/isis-developer-guides/building-and-contributing-to-isis-tutorial.md
       - Writing Tests with CTest and GTest:           how-to-guides/isis-developer-guides/writing-isis-tests-with-ctest-and-gtest.md
       - App Testing CookBook:                         how-to-guides/isis-developer-guides/app-testing-cookbook.md
       - Doxygen Tag Class Requirement:                how-to-guides/isis-developer-guides/class-requirements-for-using-doxygen-tags.md
-      - Developing ISIS3 with cmake:                  how-to-guides/isis-developer-guides/developing-isis3-with-cmake.md
-      - ISIS Development on ARM Macs:    how-to-guides/isis-developer-guides/developing-mac-m1-arm-systems.md
-      - Building and Contributing to ISIS Tutorial:   how-to-guides/isis-developer-guides/building-and-contributing-to-isis-tutorial.md
-      - ISIS Test Data:                               how-to-guides/isis-developer-guides/obtaining-maintaining-submitting-test-data.md
       - ISIS Programming Exercises:
         - Exercise 1:                                 how-to-guides/isis-developer-guides/exercise-1.md
         - Exercise 2:                                 how-to-guides/isis-developer-guides/exercise-2.md