diff --git a/index.markdown b/index.markdown
index 4153aa1..74a16ca 100644
--- a/index.markdown
+++ b/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:
-
The geometry/materials API is in python
-Models can be imported from CAD and/or GDML and mixed with native Geant4 volumes
-The geometry can be modded at run time, for example by applying tilts / displacements
{:/}"
-
-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.
+
+
+
+{:/}"
+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: "
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.
"
v2: "GEMC can manage this with a string variable called `variation`. This has the advantages:
"
@@ -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:
+**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:
-- 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
-| Database sources: code-independent simulations |
-|------------------------------------------------|
-| {{ page.description }} |
-| ![gemcArch] |
-| *{{ page.c5 }}* |
+| Database sources: no-code simulations |
+|---------------------------------------|
+| {{ page.description }} |
+| *{{ page.arc_caption }}* |
-| Python API | |
-|------------------------------|--------------------------------|
-| ![gemcExamplePic] | ![gemcCodeExample] |
-| {{ page.p1 }} {{ page.p2 }} | *{{ page.p3 }}* |
+| Python API | |
+|-------------------|--------------------------|
+| ![gemcExamplePic] | ![gemcCodeExample] |
+| {{ page.api }} | *{{ page.api_caption }}* |
@@ -59,14 +63,13 @@ It provides:
| ![clas12v] | {{ page.v1 }} {{ page.v2 }} {{ page.v3 }} {{ page.v4 }} |
| {{ page.v5 }} | {{ page.v6 }} |
-
-
-[gemcArch]: assets/images/gemcArchitecture.png
[gemcCodeExample]: assets/images/pythonAPI.png
+
[gemcExamplePic]: assets/images/pythonAPIGeo.png
+
[clas12v]: assets/images/clas12v.gif