Sort samples index and add simple section headers

DavidQ · DavidQ · commit 93f0b82da7af · 2026-04-09T11:50:34.000-04:00
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -1,8 +1,8 @@
 MODEL: GPT-5.4-codex
-REASONING: high
+REASONING: low
 
 COMMAND:
-Execute docs/pr/BUILD_PR_SAMPLES_74_INDEX_LINK_VALIDATION_CLEANUP.md exactly.
+Execute docs/pr/BUILD_PR_SAMPLES_75_INDEX_SORT_AND_SECTION_HEADERS.md exactly.
 Modify only samples/index.html.
 Package to:
-<project folder>/tmp/BUILD_PR_SAMPLES_74_INDEX_LINK_VALIDATION_CLEANUP_delta.zip
+<project folder>/tmp/BUILD_PR_SAMPLES_75_INDEX_SORT_AND_SECTION_HEADERS_delta.zip
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1 +1 @@
-Clean up samples index links (duplicates/broken)
+Sort samples index and add simple section headers
diff --git a/docs/dev/NEXT_COMMAND.txt b/docs/dev/NEXT_COMMAND.txt
@@ -1 +1 @@
-Next: identify exact sample files for phase-folder normalization
+Next: identify explicit sample files before structural changes
diff --git a/docs/dev/reports/change_summary.txt b/docs/dev/reports/change_summary.txt
@@ -1 +1 @@
-index cleanup
+index readability improvement
diff --git a/docs/dev/reports/validation_checklist.txt b/docs/dev/reports/validation_checklist.txt
@@ -1 +1 @@
-links resolve; no duplicates
+links unchanged
diff --git a/docs/pr/BUILD_PR_SAMPLES_75_INDEX_SORT_AND_SECTION_HEADERS.md b/docs/pr/BUILD_PR_SAMPLES_75_INDEX_SORT_AND_SECTION_HEADERS.md
@@ -0,0 +1,22 @@
+# BUILD PR — Samples Index Sort and Section Headers
+
+## Purpose
+Improve readability of samples/index.html by sorting entries and adding clear section headers without changing links.
+
+## Exact Target Files
+- samples/index.html
+
+## Required Code Changes
+- sort existing links alphabetically within current groups
+- add simple section headers if missing (no new structure assumptions)
+- do not add/remove links
+
+## Constraints
+- exact file only
+- no file creation
+- no path changes
+- no link changes
+
+## Acceptance Criteria
+- index is easier to scan
+- all links unchanged and still resolve

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Clean up samples index links (duplicates/broken)`
	`1`	`+Sort samples index and add simple section headers`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Next: identify exact sample files for phase-folder normalization`
	`1`	`+Next: identify explicit sample files before structural changes`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-index cleanup`
	`1`	`+index readability improvement`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-links resolve; no duplicates`
	`1`	`+links unchanged`