improving main page

index.markdown

@@ -5,16 +5,22 @@
 
 layout: default
 
-description:  "{::nomarkdown} GEMC use databases (ASCII, SQLITE, MYSQL) to create Geant4 simulation objects such as geometry, materials, etc. 
-Since no quantity is hard-coded, systems can be created or modified w/o re-compiling the code.
-In addition:<br/><br/>
-<li>The geometry/materials API is in python </li>
-<li>Models can be imported from CAD and/or GDML and mixed with native Geant4 volumes</li>
-<li>The geometry can be modded at run time, for example by applying tilts / displacements</li><br/>{:/}"
-
-p1:  "Geant4 volumes are built using the sci-g python API."
-p2:  "An example geometry: a flux scintillator paddle collects hits from protons impinging on a liquid hydrogen target"
-p3:  "The [above snippet](https://gist.github.com/maureeungaro/8e8616b388d65df0c8168a6b205f0c43) is the only code needed to build the geometry and record all tracks hitting the paddle."
+description:  "{::nomarkdown} GEMC utilizes databases (ASCII, SQLite, MySQL) to dynamically create Geant4 
+simulation objects, including geometry, materials, and more. 
+Systems can be created or modified without requiring code recompilation. 
+Additionally, geometry can be imported from CAD or GDML files and seamlessly integrated with 
+native Geant4 volumes.<br/><br/>
+<div style=\"text-align: center;\">
+    <img src=\"assets/images/gemcArchitecture.png\" style=\"width: 80%;\" />
+</div>
+{:/}"
+arc_caption: "Typical usage: detector geometries and materials are loaded from various databases sources.
+Particles are transported through materials by Geant4, hits are collected and digitized, and output(s) are created.
+Notice that GEMC users do not have to code the Geant4 simulation, but only the detector geometry and materials."
+
+api:  "Geant4 volumes are built using the python API.
+An example geometry: a flux scintillator paddle collects hits from protons impinging on a liquid hydrogen target"
+api_caption:  "The [above snippet](https://gist.github.com/maureeungaro/8e8616b388d65df0c8168a6b205f0c43) is the only code needed to build the geometry and record all tracks hitting the paddle."
 
 v1: "<br/> A detector can be re-used in multiple experiments, with configuration changes such as shifts components, changes of materials, addition or removal of certain volumes.<br/><br/>"
 v2: "GEMC can manage this with a string variable called `variation`. This has the advantages:<br/><br/>"
@@ -26,31 +32,29 @@ v6: "In the JSON steering card the two variations of clas12CD are loaded by spec
 
 ---
 
-**GEMC** (**GE**ant **M**onte-**C**arlo) is a program based on [Geant4](https://geant4.web.cern.ch) 
-to simulate the passage of particles through matter.
-It provides:<br/>
+**GEMC** (**GE**ant **M**onte-**C**arlo) is a simulation program built on [Geant4](https://geant4.web.cern.ch)
+ designed to leverage databases for modeling the passage of particles through matter. Key features include:<br/>
 
-- SQL / ASCII Databases for detector parameters like geometry and materials
-- Geometry variations
+- Python API
+- Support for geometry variations to adapt to different simulation setups
+- Pre-packaged signal digitization tools, such as flux and dosimeter simulations
+- Plugins mechanism to extend functionality, including custom user generators and digitization
 - Emulation of hardware electronics
-- Pre-packaged signal digitization such as flux and dosimeter
-- Custom users plugins mechanism for simulation aspects like generators and igitization
-- Built-in ASCII and [ROOT](https://root.cern) output
+- Built-in ASCII and [ROOT](https://root.cern) output formats
 
 <br/>
 
-| Database sources: code-independent simulations |             
-|------------------------------------------------|
-| {{ page.description }}                         |
-| ![gemcArch]                                    |
-| *{{ page.c5 }}*                                |
+| Database sources: no-code simulations |             
+|---------------------------------------|
+| {{ page.description }}                |
+| *{{ page.arc_caption }}*              |
 
 <br/><br/>
 
-| Python API                   |                                |
-|------------------------------|--------------------------------|
-| ![gemcExamplePic]            | ![gemcCodeExample]             |
-| {{ page.p1 }}  {{ page.p2 }} | *{{ page.p3 }}*                |
+| Python API        |                          |
+|-------------------|--------------------------|
+| ![gemcExamplePic] | ![gemcCodeExample]       |
+| {{ page.api }}    | *{{ page.api_caption }}* |
 
 <br/><br/>
 
@@ -59,14 +63,13 @@ It provides:<br/>
 | ![clas12v]          | {{ page.v1 }} {{ page.v2 }} {{ page.v3 }} {{ page.v4 }} |
 | {{ page.v5 }}       | {{ page.v6 }}                                           |
 
-
 <br/><br/>
 
 
 
-
-[gemcArch]: assets/images/gemcArchitecture.png
 [gemcCodeExample]: assets/images/pythonAPI.png
+
 [gemcExamplePic]: assets/images/pythonAPIGeo.png
+
 [clas12v]: assets/images/clas12v.gif