Small updates to warngen page to fix syntax and update some verbage

docs/cave/warngen.md

@@ -1,28 +1,31 @@
+# WarnGen Walkthrough
+
 WarnGen is an AWIPS graphics application for creating and issuing warnings as is done by National Weather Service offices.  In the Unidata AWIPS release it is a *non-operational* forecasting tool, meaning it allows users to experiment and simulate with the drawing and text-generation tools, but prevents you from transmitting a generated warning upstream.
 
 !!! warning "In order to select a feature it must be within your *CAVE localization* coverage (load **Maps** > **County Warning Areas** to see coverages)"
 
-Steps involved in using WarnGen in Unidata AWIPS CAVE
+## Quick Steps - Using WarnGen in Unidata AWIPS CAVE
 
-* Load NEXRAD Display from the Radar menu
+1. [**Load NEXRAD Display**](#load-nexrad-level-3-display) from the Radar menu
-* Choose a CWA with active severe weather (PAH is used in the video below)
+2. Choose a CWA with active severe weather (PAH is used in the video below)
-* Re-localize to this site in the **CAVE** > **Preferences** > **Localization** menu
+3. [**Re-localize**](#select-site-localization) to this site in the **CAVE** > **Preferences** > **Localization** menu
-* Exit out of CAVE and reload (you should notice the new CWA at the top of CAVE)
+4. Exit out of CAVE and reload (you should notice the new CWA at the top of CAVE)
-* Load radar data from the local radar menu **kpah** > **Z + SRM8**
+5. [**Load radar data**](#load-single-radar-data-from-the-local-radars) from the local radar menu **kpah** > **Z + SRM8**
-* Use the "period" key in the number pad to toggle between the 0.5 Reflectivity and SRM
+6. Use the "period" key in the number pad to toggle between the 0.5 Reflectivity and SRM
-* Click the WarnGen toolbar button or load from **Tools** > **WarnGen**
+7. Click [**WarnGen**](#launch-warngen) toolbar button or load from **Tools** > **WarnGen**
-* Drag the storm marker to the center of a storm feature
+8. [**Drag the storm marker**](#generate-a-storm-motion-vector) to the center of a storm feature
-* Step through frames back and forth and adjust the marker to match the trajectory of the storm feature
+9. Step through frames back and forth and adjust the marker to match the trajectory of the storm feature
-* Click **Track** in the Warngen GUI to update the polygon shape and trajectory
+10. Click **Track** in the Warngen GUI to update the polygon shape and trajectory
-* From the WarnGen dialog select the type of warning to generate, time range, basis of the warning, and any threats (wind, hail, etc)
+11. From the WarnGen dialog select the type of warning to generate, time range, basis of the warning, and any threats (wind, hail, etc)
-* Click "Create Text" at the bottom of the WarnGen dialog to generate a text warning product in a new window
+12. Click [**Create Text**](#text-window) at the bottom of the WarnGen dialog to generate a text warning product in a new window
-* Note: Since you are not "issuing" the warning, leave the top to rows blank ("TTAAii" and "CCCC") and Click "Enter" and a separate text window should open 
+
+ > Note: Since you are not "issuing" the warning, leave the top to rows blank ("TTAAii" and "CCCC") and Click "Enter" and a separate text window should open 
     
 ![](../images/warngenHeaderBlock.png)
 
-* Click "Reset" at the top of the WarnGen dialog to reset the storm marker at any time.
+13. Click [**Reset**](#redrawing-a-polygon) at the top of the WarnGen dialog to reset the storm marker at any time
-* Select "Line of Storms" to enable a two-pointed vector which is to be positioned parallel to a storm line
+14. Select **Line of Storms** to enable a two-pointed vector which is to be positioned parallel to a storm line
-* To add another vertex, middle button click along the polygon
+15. To [**add another vertex**](#add-and-remove-vertex-points), middle button click along the polygon
 
 ## Video - Using WarnGen in AWIPS
 
@@ -44,6 +47,7 @@ Open **CAVE** > **Preferences** > **Localization**, select the CWA site ID (PAH)
 ## Load single radar data from the local radars
 
 Click on the local radar **kpah** > **Z + SRM8**. Use the "period" key in the number pad to toggle between the 0.5 Reflectivity and SRM.
+
 ![](../images/warngenLocalRadar.png)
 
 ## Launch WarnGen
@@ -62,51 +66,49 @@ Select **WarnGen** from the D2D Toolbar or from the **Tools** > **WarnGen** m
 
 ![](../images/warngenDMTS.png)
 
-## Restart
+The initial polygon may have unhatched areas that will be removed from the warning due to crossing CWAs or not meeting area thresholds in the county for inclusion. The Warned/Hatched Area button allows you to preview the polygon shape that will be issued, so you can make further edits.
-
-Click the **Reset** button to clear all current polygons and vectors and reset the storm centroid marker.
-
-## Redrawing a Polygon
-
-Select the **Track** button in the **"Redraw Box on Screen"** section to redraw a default warning polygon oriented along the storm motion track and containing the storm centroid dot for the most recent volume scan. The initial polygon may have unhatched areas that will be removed from the warning due to crossing CWAs or not meeting area thresholds in the county for inclusion. The Warned/Hatched Area button allow you to preview the polygon shape that will be issued, so you can make further edits.
 
 ## Moving Vertex Points
 
 Vertices can be moved by clicking and dragging with the mouse. The warning polygon, including stippling, will update automatically.
 
-![](../images/warnpoly.png)
+![](../images/warngenPoly.png)
 
-When reshaping your warning polygon in this manner, the philosophy is to include all areas that are at risk of experiencing severe weather covered by that warning type. Effective polygons account for uncertainty over time and typically widen downstream. There will be a lot of training provided on Storm-Based Warning Fundamentals in RAC and in the workshop, and this lesson is more focused on the basic mechanics.
+When reshaping your warning polygon in this manner, the philosophy is to include all areas that are at risk of experiencing severe weather covered by that warning type. Effective polygons account for uncertainty over time and typically widen downstream. 
 
 ## Add and Remove Vertex Points
 
 There will be some occasions where you will want to add vertices to your warning polygon. Most often, these situations will involve line warnings with bowing segments or single storm warnings where you want to account for storm motion uncertainty or multiple threat areas that may have differing storm motions.
 
-New vertices are added to the warning polygon using a context relative menu accessed by selecting the warning polygon line segments with a **Right Mouse Button "click and hold"** or a simple **Middle Mouse Button** while at the location you want to add a vertex.
+New vertices are added to the warning polygon two ways. Either by **Right Mouse Button** "click and hold" or a simple **Middle Mouse Button** click on the warning polygon line segment where you want to add the vertex.
 
-1. Hold right-click and select **add vertex**.
+Vertex points are removed from the warning polygon using the same context relative menu. Instead of selecting a line segment, you select the vertex you wish to remove and then right mouse button **click and hold** and select **remove vertex**.
-2. Click the left mouse button at the location you desire for the new vertex and the point is created there.
-3. Clicking the middle mouse button (or scroll wheel) along an edge of the polygon will also place a vertex at that point.
 
-Vertex points are removed from the warning polygon using the same context relative menu. Instead of selecting a line segment, you select the vertex you wish to remove and then **click and hold** with right mouse button.  Hold right-click and select **remove vertex**.
+## Redrawing a Polygon
 
-## Restoring a Polygon
+Click the **Reset** button to clear the current polygon and vector and reset the storm centroid marker. Generate a new storm motion by moving the storm markers and select the **Track** button in the WarnGen GUI to draw the new polygon.
 
-When you are customizing a polygon in WarnGen, speed is critical. Everyone, even veteran warning forecasters, will occasionally draw a warning polygon one way and then realize, prior to sending the warning, that they want to draw the warning boundaries differently. Depending on the complexity of the changes you make to a warning polygon, sometimes it’s faster to just start over from scratch. The easiest way to proceed, especially if you are still comfortable with the storm motion, is to select the “Track” button from the “Redraw Box on Screen from” section of the WarnGen GUI.
+<!--
+# Restoring a Polygon
+
+When you are customizing a polygon in WarnGen, speed is critical. Everyone, even veteran warning forecasters, will occasionally draw a warning polygon one way and then realize, prior to sending the warning, that they want to draw the warning boundaries differently. Depending on the complexity of the changes you make to a warning polygon, sometimes it’s faster to just start over from scratch. The easiest way to proceed, especially if you are still comfortable with the storm motion, is to select the “Track” the WarnGen GUI.
+-->
 
 ## Text Window
 
-Using the customized settings in the WarnGen GUI, WarnGen translates the information into a text product that is displayed in a text window on the Text Display. Initially the AWIPS Header Block window appears, and you will just click Enter to modify the text of the warning. 
+Once you are satisfied with your polygon and have chosen your selections, click **Create Text** in the WarnGen GUI. Initially the AWIPS Header Block window appears. Leave the top two rows bank and click **Enter** for the text window to open. 
 
 ![](../images/warngenHeaderBlock.png)
 
-The auto-generated text contains the storm speed and direction, the counties and cities affected by the warning/advisory, the valid times of the product, the warning/advisory body text (including any optional bullets selected in the GUI), and additional code to help our partners to efficiently process and disseminate the warning/advisory. The locked parts of the text are highlighted in blue and most of your text should not need to be edited if you configured your WarnGen window correctly.
+Using the customized settings in the WarnGen GUI, WarnGen translates the information into a text product that is displayed in a text window on the Text Display. The auto-generated text contains the storm speed and direction, the counties and cities affected by the warning/advisory, the valid times of the product, the warning/advisory body text (including any optional bullets selected in the GUI), and additional code to help our partners to efficiently process and disseminate the warning/advisory. The locked parts of the text are highlighted in blue and most of your text should not need to be edited if you configured your WarnGen window correctly.
 
-!!! danger "The Unidata AWIPS software is non-operational, so you will not be able to "issue" or send the warnings you create"
+!!! danger "The Unidata AWIPS release is *non-operational*. You will be allowed to simulate the drawing and text-generation of warnings, but are **prevented from transmitting** a generated warning upstream"
 
+<!--
 For some products like Severe Weather Statements, there are parts of text that must be edited that have wild-card characters around them that need to be removed after modifying the text inside (e.g. !** WEAKENED.MOVED OUT OF THE WARNED AREA. **!). When you attempt to send a product, WarnGen will instruct you to modify this text if you have not. Once the text looks ready for submission you click the Send button, and, on a live system, the warning will be transmitted for public broadcast after you press the Go Ahead button on the final WarnGen check. WES-2 Bridge has been implemented in a way that cannot interact with the live AWIPS processes and communications, so warnings issued on the WES-2 Bridge will not be transmitted as live products.
+-->
 
-NOTE: Edits made to product text in the editor window should be limited to items such as forecaster name/initials, call-to-action text, etc. If changes are warranted for items such as storm motion, warned counties, or Latitude/Longitude points, close the editor window and make changes using the D-2D and WarnGen graphical tools, then recreate the polygon and/or the text.
+> Note: Edits made to product text in the editor window should be limited to items such as forecaster name/initials, call-to-action text, etc. If changes are warranted for items such as storm motion, warned counties, or Latitude/Longitude points, close the editor window and make changes using the D-2D and WarnGen graphical tools, then recreate the polygon and/or the text.
 
 <!--
 ## "Issuing" a Warning