diff --git a/src/config/sidebar.yml b/src/config/sidebar.yml
index 2393b665de6d44ea9901c80dcdf1c9f484599459..fc44fc94b6e76f4cbc0ecaa8038a4217187a1e98 100644
--- a/src/config/sidebar.yml
+++ b/src/config/sidebar.yml
@@ -36,6 +36,8 @@
       link: 'https://github.com/AIDASoft/DD4hep/blob/master/DDCore/include/XML/UnicodeValues.h'
     - label: 'NPdet Documenation'
       link: 'https://eic.phy.anl.gov/npdet/'
+    - label: 'eicd - EIC Data Model'
+      link: 'https://eic.phy.anl.gov/eicd/'
     - label: 'Links'
       link: '/links'
       #- label: Usage
diff --git a/src/docs/getting-started/quickstart.mdx b/src/docs/getting-started/quickstart.mdx
index 58427ff3f996ab17481e1bc45ac1b0c4a90f8bb0..b062bcf14ae32edd9a1f49e43b08d2f9ba928374 100644
--- a/src/docs/getting-started/quickstart.mdx
+++ b/src/docs/getting-started/quickstart.mdx
@@ -13,14 +13,11 @@ The programmer is assumed to be familiar with
 
 This tutorial requires that [singularity](singularity) is installed 
 on the local system. 
-Singularity can be downloaded by going to
-https://sylabs.io/guides/3.7/user-guide/quick_start.html , with 3.7 being the 
+Singularity can be [downloaded here](https://sylabs.io/guides/3.7/user-guide/quick_start.html) -- 3.7 being the 
 most recent version as of January 2021.
  
-
 ## The EIC Software Container
 
-
 ### Step 1: Create a local directory that you want to work in, e.g., `~/eic`
 ```bash
 mkdir ~/eic
@@ -70,7 +67,8 @@ dd_web_display --export athena.xml
 This will generate the file `detector_geometry.root`, which you should copy to your local machine.
 Then open the [web viewer](https://eic.phy.anl.gov/geoviewer/), click on the `...` and open the local root file.
 
-Or if you want to skip this just [click here to view the latest detector](https://eic.phy.anl.gov/geoviewer/index.htm?file=https://eicweb.phy.anl.gov/api/v4/projects/473/jobs/artifacts/master/raw/geo/detector_geo_full.root?job=report&item=default;1&opt=clipxyz;transp30;zoom75;ROTY290;ROTZ350;trz0;trr0;ctrl;all&).
+Or if you want to skip this just 
+[click here to view the latest detector](https://eic.phy.anl.gov/geoviewer/index.htm?file=https://eicweb.phy.anl.gov/api/v4/projects/473/jobs/artifacts/master/raw/geo/detector_geo_full.root?job=report&item=default;1&opt=clipxyz;transp30;zoom75;ROTY290;ROTZ350;trz0;trr0;ctrl;all&).
 
 
 
diff --git a/src/docs/part1/simple_detector.md b/src/docs/part1/simple_detector.md
index 1a3df764755a87905a441556de0c0fa01f2ace5b..031370d4edc831fba94cfdf84d67ccad4c5b697c 100644
--- a/src/docs/part1/simple_detector.md
+++ b/src/docs/part1/simple_detector.md
@@ -150,7 +150,7 @@ At the top of the script you can see these lines:
   dd4hep::rec::CellIDPositionConverter cellid_converter(detector);
 ```
 This 
-  - gets the DD4hep instance
+  - gets the main [DD4hep Detector](https://dd4hep.web.cern.ch/dd4hep/reference/classdd4hep_1_1Detector.html) instance
   - loads the compact detector file
   - initializes the [position converter tool](https://dd4hep.web.cern.ch/dd4hep/reference/classdd4hep_1_1rec_1_1CellIDPositionConverter.html) (which provides thread safe access)
 
@@ -165,14 +165,13 @@ Later on you can see its use:
 root -b -q scripts/tutorial2_cell_size.cxx+
 ```
 
-[You](You) will see this:
+You will see this:
 ```bash
 ...
 Segmentation-Cell Position : 39,102,-100
  dim 1, 3, 
 ```
 
-
 ### Id Specification
 
 ```bash