docs: link setup-exercises in README; sample-book: add Setup page including setup exercise and update SUMMARY

guyernest · guyernest · commit eaf5f9927f98 · 2025-12-28T18:29:11.000-08:00
diff --git a/README.md b/README.md
@@ -429,6 +429,7 @@ See the [examples](./examples) directory for complete exercise examples:
 ### Course Developer Guides
 
 - Organizing and integrating exercises (include-only pattern): see `docs/exercises-integration.md`.
+- Setup exercises (ID suffix `-setup`, position `00`): see `docs/setup-exercises.md`.
 
 ### Sample mdBook
 
diff --git a/sample-book/src/SUMMARY.md b/sample-book/src/SUMMARY.md
@@ -1,4 +1,5 @@
 # Summary
 
 - [Introduction](intro.md)
+- [Setup](setup.md)
 - [Exercises](exercises.md)
diff --git a/sample-book/src/setup.md b/sample-book/src/setup.md
@@ -0,0 +1,5 @@
+# Environment Setup
+
+This page demonstrates a setup exercise included at the start of a chapter. Setup exercises use the same directives as regular exercises and are identified by an ID that ends with `-setup` (recommended position `00`).
+
+{{#exercise ../../examples/ch02-environment-setup.md}}
