From 0ea5c47c037e06396ea0c31769e959c58dea2b1c Mon Sep 17 00:00:00 2001
From: brutzman <brutzman@nps.edu>
Date: Mon, 21 Aug 2023 07:19:31 -0700
Subject: [PATCH] editorial detail, clarity

---
 distribution.html | 48 +++++++++++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 20 deletions(-)

diff --git a/distribution.html b/distribution.html
index 9f684ef693..6caa2cfacc 100644
--- a/distribution.html
+++ b/distribution.html
@@ -27,17 +27,21 @@
             The IEEE 
             <a href="https://en.wikipedia.org/wiki/Distributed_Interactive_Simulation">Distributed Interactive Simulation (DIS)</a> protocol
             is a formal standard for conducting real-time platform-level wargaming across multiple host computers and is used worldwide, especially by military organizations.
+            To learn more:
         </p>
         <ul>
             <li>
                 <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/blob/master/conferences/IITSEC2021/README.md" target="_blank">Distributed Interactive Simulation (DIS) 101 Tutorial: The Basics</a>,
                 Interservice Industry Training, Simulation Education Conference (IITSEC), 29 November - 3 December 2021, Orlando Florida USA.
             </li>
+            <li>
+                <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/blob/master/specifications/IeeeDisPduColorFigures.pdf" target="_blank">IEEE DIS7 PDU color figures</a>
+                illustrate PDU data structures that are used to carry networked messages about shared network state.
+            </li>
         </ul>
         <p>
-            This page offers distribution products created from the latest build of the 
-            <a href="https://github.com/open-dis/opendis7-java/blob/master/README.md" target="_blank">opendis7-java project</a>
-            source code.
+            This page offers distribution products for software developers, created from the latest build of source code in the 
+            <a href="https://github.com/open-dis/opendis7-java/blob/master/README.md" target="_blank">opendis7-java project</a>.
         </p>
         
         <hr />
@@ -50,39 +54,43 @@
         <p>
             <i>Get set...</i>
         </p>
+        
+        <p>
+            Here are distribution products for Java software development.
+        </p>
         <ul>
-            <li>
-                <a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/blob/master/specifications/IeeeDisPduColorFigures.pdf" target="_blank">IEEE DIS7 PDU color figures</a>
-                illustrating PDU data structures
-            </li>
             <li>
                 <a href="https://savage.nps.edu/opendis7-java/javadoc/index.html" target="_blank">opendis7-java Javadoc</a>
                 provides full documentation of classes and methods for Java programmers
             </li>
             <li>
                 <a href="https://savage.nps.edu/opendis7-java/opendis7-full.jar">opendis7-full.jar</a>
-                is the latest recommended version for use.
+                is the latest recommended version for developer use.
                 It is a 
                 "<a href="https://stackoverflow.com/questions/19150811/what-is-a-fat-jar" target="_blank">fat&nbsp;jar</a>"
                 (~210MB) which integrates all of the following:
                 
                 <ul>
                     <li>
-                        <a href="https://savage.nps.edu/opendis7-java/opendis7-pdus-classes.jar">opendis7-pdus-classes.jar</a>,
-                        <a href="https://savage.nps.edu/opendis7-java/opendis7-pdus-javadoc.jar">opendis7-pdus-javadoc.jar</a>,
-                        <a href="https://savage.nps.edu/opendis7-java/opendis7-pdus-source.jar">opendis7-pdus-source.jar</a>
+                        <a href="https://savage.nps.edu/opendis7-java/opendis7-pdus-source.jar">opendis7-pdus-source.jar</a>,
+                        &nbsp;
+                        <a href="https://savage.nps.edu/opendis7-java/opendis7-enumerations-source.jar">opendis7-enumerations-source.jar</a>
                     </li>
                     <li>
-                        <a href="https://savage.nps.edu/opendis7-java/opendis7-enumerations-classes.jar">opendis7-enumerations-classes.jar</a>,
-                        <a href="https://savage.nps.edu/opendis7-java/opendis7-enumerations-javadoc.jar">opendis7-enumerations-javadoc.jar</a>,
-                        <a href="https://savage.nps.edu/opendis7-java/opendis7-enumerations-source.jar">opendis7-enumerations-source.jar</a>
+                        <a href="https://savage.nps.edu/opendis7-java/opendis7-pdus-classes.jar">opendis7-pdus-classes.jar</a>,&nbsp;
+                        <a href="https://savage.nps.edu/opendis7-java/opendis7-enumerations-classes.jar">opendis7-enumerations-classes.jar</a>
+                    </li>
+                    <li>
+                        <a href="https://savage.nps.edu/opendis7-java/opendis7-pdus-javadoc.jar">opendis7-pdus-javadoc.jar</a>,
+                        <a href="https://savage.nps.edu/opendis7-java/opendis7-enumerations-javadoc.jar">opendis7-enumerations-javadoc.jar</a>
                     </li>
                 </ul>
             </li>
         </ul>
             
         <p>
-            Experimental XML encoding for DIS Protocol version&nbsp;7, enabling opportunities for further 
+            The IEEE DIS Protocol is a a carefully defined set of binary messages.
+            We are also working on an experimental XML encoding for DIS Protocol version&nbsp;7, enabling opportunities for further 
             "<a href="https://en.wikipedia.org/wiki/Big_data" target="_blank">big data</a>"
             validation and conversion.
             Current work is testing and building upon these potential capabilities.
@@ -95,7 +103,7 @@
                 <a href="https://savage.nps.edu/opendis7-java/xml/SchemaDocumentation/DIS_7_2012.autogenerated.html" target="_blank">DIS7 PDU XML Schema Documentation</a>
             </li>
             <li>    
-                generated from original 
+                These XML data structures are generated from original 
                 <a href="https://github.com/open-dis/opendis7-source-generator/tree/master/xml/dis_7_2012" target="_blank">XML for PDUs design templates</a>
                 by Don McGregor
             </li>
@@ -130,14 +138,14 @@
             <i>Go!</i>
         </p>
         
-        <blockquote>
+        <p>
 This NPS course is an introduction to distributed communications in simulation applications.
 Topics include introduction to the TCP/IP protocol stack,
 socket communications including TCP/UDP unicast/multicast and essential protocol design issues.
 Follow-on emphasis is Distributed Interactive Simulation (DIS) Protocol application programming,
 with side looks at High Level Architecture (HLA). Course activity focuses on creation and testing
 of network programming network code and web-browser applications.
-        </blockquote>
+        </p>
 
         <ul>
             <li>
@@ -146,7 +154,7 @@ of network programming network code and web-browser applications.
                 <ul>
                     <li>
                         <a href="https://savage.nps.edu/opendis7-java/javadoc-examples/index.html" target="_blank">course examples Javadoc</a>
-                        &nbsp; &nbsp;&nbsp; <!-- rough spacing alignment -->
+                        &nbsp; &nbsp; &nbsp; <!-- rough spacing alignment -->
                         (<a href="https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500/-/tree/master/examples" target="_blank">source code</a>)
                     </li>
                     <li>
@@ -183,7 +191,7 @@ of network programming network code and web-browser applications.
         </blockquote>
         
         <blockquote>
-            This page updated 20 August 2023
+            This page updated 21 August 2023
         </blockquote>
         
     </body>
-- 
GitLab