Merge pull request #12 from mars-sim/start_chooser

Update for startup chooser

Author: bevans2000

content/docs/guide/started/installation.md

@@ -4,20 +4,35 @@ description: Details of installation procedure
 weight: 10
 ---
 
-## Prerequisites
+There are two installation packages available for the Simulation.
+
+- Windows MSI File
+- ZIP file
+
+## Windows MSI
+
+This approach provides a shrink wrapped installation of the UI application. It does not contain the headless server version. This can be downloaded from Assets section in [Releases](https://github.com/mars-sim/mars-sim/releases) as a MSI file that is applicable for a Windows installation.
+
+This has no prerequisites.
+
+## ZIP File
+
+This approach is more complex but provides a wider range of options. Command lines arguments can be used.
+
+### Prerequisites
 
 Currently, mars-sim supports Java 21 which is a LTS (Long Term Support release). Requires only JRE 21 for running mars-sim. See [JDK21](https://jdk.java.net/java-se-ri/21)
 
 The application supports Windows or Linux. MacOS is supported but not via a command script; Java must be called directly.
 
-## Applications
+### Applications
 
 The installation consists of 2 application:
 
 - A UI application based on Java Swing
 - A headless server version that can be accessed remotely via an SSH interface.
 
-## Installation Process
+### Installation Process
 
 The installation process is simple requiring command line access.
 

content/docs/guide/started/starting.md

@@ -5,7 +5,18 @@ description: Starting Simulation instructions
 weight: 30
 ---
 
-The distribution supports both Windows and Linux.
+## Quick Start Sequence
+
+Starting the simulation with no arguments or via the MSI installation will present the StartUp Chooser offering a number of options. 
+
+{{< figure src="/images/screenshots/starter.png" caption="Main Starter" >}}
+
+The _New_ option start a new Simulation using the [Default](../../../definitions/scenario/default) Scenario. Whilst the _Select Scenario_ allows the selecting of a different pre-defined Scenario in a new Simulation.
+
+## Command Line Starting Sequence
+
+The ZIP distribution supports both Windows and Linux and uses a command line starting sequence.
+
 It also provides 2 variants of the mars-sim application.
 1. Swing based UI
 2. Console based engine that is accessed via SSH
@@ -21,16 +32,16 @@ Start commands are:
 Common command line arguments are:
  -baseurl <URL to remote content>    URL to the remote content repository
                                      (defaults to master in GitHub)
- -crew <true|false>                  Enable or disable use of the crews
+ -configdir <directory>              Directory for configurations files
  -datadir <path to data directory>   Path to the data directory for
                                      simulation files (defaults to user.home)
  -diags <<module>,<module>.....>     Enable diagnostics modules
  -help                               Display help options
- -lat <latitude>                     Set the latitude of the new template Settlement
  -load <path to simulation file>     Load the a previously saved sim.
                                      No argument open file selection dialog.
                                      'default' will use default
- -lon <longitude>                    Set the longitude of the new template Settlement
+ -location <coordinates>             Set the coordinates of the new template Settlement
+ -log <logfile [size K|M|G:count]>   Enable logging to a logfile sequence with an optional size per file
  -new                                Enable quick start
  -scenario <scenario name>           New simulation from a scenario
 
@@ -41,9 +52,7 @@ Common command line arguments are:
 Swing variant arguments
  -cleanui                            Disable loading stored UI configurations
  -noaudio                            Disable the audio
- -nogui                              Disable the main UI
  -profile                            Set up the Commander Profile
- -sandbox                            Start in Sandbox Mode
  -site                               Start the Scenario Editor
  
 Console variant arguments