Move feature education docs to reference

Co-authored-by: Orca <help@stably.ai>

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
 

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',