From 6e87653bf01a4b00b231fc4c2077c78c85f7eb65 Mon Sep 17 00:00:00 2001
From: Whitney Armstrong <warmstrong@anl.gov>
Date: Mon, 23 Mar 2020 20:36:01 -0500
Subject: [PATCH] 	modified:   background.md 	modified:   index.mdx 
 modified:   links.md 	modified:   part1/simple_detector.md

---
 src/docs/background.md            |  3 +--
 src/docs/index.mdx                |  1 +
 src/docs/links.md                 |  4 +++-
 src/docs/part1/simple_detector.md | 28 ++++++++++++++++++++++++++++
 4 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/src/docs/background.md b/src/docs/background.md
index 9c29571..dd516dc 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 c338b32..a040806 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 bd297f6..7dde024 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 4d249e8..6ed649f 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
-- 
GitLab