diff --git a/docs/reference/README.md b/docs/reference/README.md
index 1b5477dd7a3..6da0ca88af2 100644
--- a/docs/reference/README.md
+++ b/docs/reference/README.md
@@ -9,6 +9,7 @@ single design or implementation pass.
 - Public-facing docs that are not part of the root README.
 - Docs that other checked-in files link to.
 - Telemetry availability notes that dashboard authors need after the original design or implementation branch is gone. See [Telemetry Availability](./telemetry-availability.md).
+- Feature education state and retention analytics notes that define how contextual tours are persisted and measured. See [Feature Education State](./feature-education-state.md) and [Feature Education Retention Analytics](./feature-education-retention-analytics.md).
 
 ## What Stays Out
 
diff --git a/docs/readme/feature-education-retention-analytics.md b/docs/reference/feature-education-retention-analytics.md
similarity index 100%
rename from docs/readme/feature-education-retention-analytics.md
rename to docs/reference/feature-education-retention-analytics.md
diff --git a/docs/readme/feature-education-state.md b/docs/reference/feature-education-state.md
similarity index 100%
rename from docs/readme/feature-education-state.md
rename to docs/reference/feature-education-state.md
diff --git a/src/shared/feature-interactions.ts b/src/shared/feature-interactions.ts
index ad296bc25b0..7635911843e 100644
--- a/src/shared/feature-interactions.ts
+++ b/src/shared/feature-interactions.ts
@@ -23,7 +23,7 @@ export type FeatureInteractionState = Partial<
 >
 
 // Why: education state has three separate meanings; see
-// docs/readme/feature-education-state.md before adding or reusing ids here.
+// docs/reference/feature-education-state.md before adding or reusing ids here.
 export const FEATURE_INTERACTIONS = [
   {
     id: 'right-sidebar',