diff --git a/src/docs/background.md b/src/docs/background.md
index 9c2957141a087d5fb6c685d6446ce23ccb7f6f26..dd516dcf7bb9377f94afbd8b1cf61ebcf40ef43b 100644
--- a/src/docs/background.md
+++ b/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
 
diff --git a/src/docs/index.mdx b/src/docs/index.mdx
index c338b3244a04ec410c6b886051adcf74dd224733..a040806e68184ae4f026e6bf3857aeecaad6f23c 100644
--- a/src/docs/index.mdx
+++ b/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)
 
 
diff --git a/src/docs/links.md b/src/docs/links.md
index bd297f6a812d631217e08054cfb88eafadba3f96..7dde024876cdb3444161d45452411b156fc746d1 100644
--- a/src/docs/links.md
+++ b/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
diff --git a/src/docs/part1/simple_detector.md b/src/docs/part1/simple_detector.md
index 4d249e87307afd39d96825c4a42b1fd73248a909..6ed649f580a28277acb6ab3b03fac5460be153a8 100644
--- a/src/docs/part1/simple_detector.md
+++ b/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