modified: background.md

	modified:   index.mdx
	modified:   links.md
	modified:   part1/simple_detector.md

src/docs/background.md

@@ -3,7 +3,7 @@ title: "Background"
 ---
 
 
-## The "Framework" Discussion
+## The "Framework" Question
 
 In the nuclear and particle physics communities many software frameworks exists.
 They come in all sizes and scopes. 
@@ -25,5 +25,4 @@ number are very different tasks.
 A tool or framework that allows this look up of geometry from channel number is 
 important for flexible use of independent tracking and reconstruction tools. 
 
-### The I
 

src/docs/index.mdx

@@ -35,5 +35,6 @@ This tutorial shows how to add new parameterized detectors to a library of gener
 
 <Background />
 
+![workflow](eic_software-figure6.svg)
 
 

src/docs/links.md

@@ -4,7 +4,7 @@ title: "Useful links"
 
 ## DD4hep Links
 
-- http://hep-fcc.github.io/FCCSW/tutorials/FCCSW/Detector/doc/DD4hepInFCCSW.html
+- User manual: https://dd4hep.web.cern.ch/dd4hep/usermanuals/DD4hepManual/DD4hepManual.pdf
 - https://dd4hep.web.cern.ch/
 - https://dd4hep.web.cern.ch/dd4hep/reference/
 
@@ -16,6 +16,8 @@ Talks:
 - https://indico.cern.ch/event/773049/contributions/3474743/attachments/1938118/3213628/gaede_dd4hep_chep19_v1.pdf
 - CMS and DD4hep https://indico.cern.ch/event/773049/contributions/3474725/attachments/1935943/3212061/cmsDD4hepMigration.pdf
 
+FCC Software project
+- http://hep-fcc.github.io/FCCSW/tutorials/FCCSW/Detector/doc/DD4hepInFCCSW.html
 
 
 ## ACTS

src/docs/part1/simple_detector.md

@@ -9,6 +9,34 @@ git clone https://eicweb.phy.anl.gov/Argonne_EIC/tutorial/tutorial_part1.git
 cd tutorial_part1
 ```
 
+You will find the following files and directories.
+```shell
+.
+├── elements.xml
+├── gem_tracker.xml
+├── gps.mac
+├── materials.xml
+├── README.md
+├── rootlogon.C
+├── run_example
+└── scripts
+    ├── example_Acts.cxx
+    ├── example_cell_size.cxx
+    ├── example_digi.cxx
+    ├── example_hit_recon.cxx
+    ├── example_seg_size.cxx
+    ├── example_tracking.cxx
+    └── mag_field.cxx
+```
+
+The files `materials.xml`, `elements.xml`,  and `gem_tracker.xml` are the 
+compact detector description files. 
+
+
+
+
+https://dd4hep.web.cern.ch/dd4hep/usermanuals/DD4hepManual/DD4hepManual.pdf
+
 ## Run the geant4 simulation
 
 ```bash