diff --git a/src/docs/background.md b/src/docs/background.md
index dd516dcf7bb9377f94afbd8b1cf61ebcf40ef43b..baccc8620e461df2004d972b9a3b81412fbf29e7 100644
--- a/src/docs/background.md
+++ b/src/docs/background.md
@@ -2,6 +2,7 @@
 title: "Background"
 ---
 
+Some of the instructions in this tutorial may be outdated. Please feel free to [leave an issue to correct these](https://eicweb.phy.anl.gov/EIC/tutorials/eic_tutorial/-/issues).
 
 ## The "Framework" Question
 
diff --git a/src/docs/index.mdx b/src/docs/index.mdx
index 95d8bb990f7fe440b978ccf12971230ca87afda0..0fc125c4cfe77a60392a9c556c5f6e23f981a3d7 100644
--- a/src/docs/index.mdx
+++ b/src/docs/index.mdx
@@ -15,9 +15,9 @@ together to get some results and serve as a jumping off point for further develo
 
 - [Quick start](getting-started/quickstart) - Start here to download software and configure your development environment.
 
-- [Part 1](part1.md) - An introduction to the detector description starting with a simple detector. 
+- [Part 1](part1/simple_detector.md) - An introduction to the detector description starting with a simple detector. 
 
-- [Part 2](part2.md) - This tutorial shows how to add new parameterized detectors to a library of generic detectors (NPdet).
+- [Part 2](part2/adding_detectors.md) - This tutorial shows how to add new parameterized detectors to a library of generic detectors (NPdet).
 
 
 ## Background Discussion