Skip to content

chore(docs): remove superseded tracking docs (content -> issues)#25

Merged
ahmetabdullahgultekin merged 1 commit into
mainfrom
chore/doc-cleanup-tracking-docs
Jun 13, 2026
Merged

chore(docs): remove superseded tracking docs (content -> issues)#25
ahmetabdullahgultekin merged 1 commit into
mainfrom
chore/doc-cleanup-tracking-docs

Conversation

@ahmetabdullahgultekin

Copy link
Copy Markdown
Contributor

Summary

Removes 41 dated/disposable tracking documents from the documentation book. These are months-old completed-work artifacts (Oct-2025 -> 2026-05) whose actionable content has shipped, is captured in the numbered reference sections, or is already covered by the prior org-wide issue sweep. The VitePress reference book itself (numbered sections, ADRs, diagrams, design specs, setup guides) is untouched.

Verification (per doc-cleanup METHOD)

Each delete-candidate's open items were checked against current HEAD before removal:

  • 03-development/IMPLEMENTATION_ROADMAP.md (Oct-2025 MVP roadmap) — all listed tasks verified shipped on client-apps HEAD (541e1297): Koin DI present, DesktopTokenStorage/IosTokenStorage/AndroidTokenStorage exist, ErrorMapper.kt present, AndroidSecureStorage + EncryptedSharedPreferences present, liveness in production. Nothing genuinely open.
  • audits/AUDIT_2026-04-19.md — dated five-team audit of a much earlier system state; superseded by the 2026-06-01/02/03 review wave and the prior md-migrate issue pass. No un-filed live item.
  • Remaining archive docs are report/analysis/status/critique/fix-plan/progress/test-report snapshots, non-actionable today.

Docs removed (41)

  • 03-development/IMPLEMENTATION_ROADMAP.md
  • audits/AUDIT_2026-04-19.md (dir now empty)
  • archive/LOGIN_SURFACES_COMPARISON_2026-04-26.md
  • archive/2026-04-16/ (31): ADD_CRITICAL_ANALYSIS_AND_RECOMMENDATIONS, ADD_CRITIQUE_REPORT, ADD_FIX_PLAN, ADD_FIX_PROGRESS, ADD_GAP_ANALYSIS, ADD_REAL_ANALYSIS, API_CONTRACT_ANALYSIS, API_CONTRACT_FIX_PLAN, AUTH_METHOD_AUDIT, AUTH_TEST_VS_WEBAPP_ANALYSIS, BACKEND_DAY_1_PLAN, BACKEND_NEXT_STEPS, BACKEND_REVIEW, BACKEND_TEST_REPORT, CODE_ANALYSIS, DOCS_MODULE_DESIGN_ANALYSIS, DOCS_MODULE_FINAL_COMPLETION_REPORT, DOCS_MODULE_IMPLEMENTATION_PLAN, DOCS_MODULE_IMPLEMENTATION_SUMMARY, FINAL_COMPLETION_REPORT, IMPLEMENTATION_STATUS_REPORT, IMPLEMENTATION_STATUS_REPORT_07-status, IMPLEMENTATION_SUMMARY_PGVECTOR, IMPROVEMENT_RECOMMENDATIONS, KMP_IMPLEMENTATION_STATUS, MOBILE_APP_INVESTIGATION_2026, MOBILE_APP_REFACTORING_PLAN, MOBILE_APP_STATUS, PGVECTOR_IMPLEMENTATION_CHECKLIST, PROJECT_PROGRESS_PRESENTATION, SCREENSHOTS_NEEDED
  • archive/2026-05-28/ (7, dir now empty): SERVICES_OVERVIEW, test-report, biometric-processor, client-apps, identity-core-api, web-app, documentation

Reference docs KEPT

In archive/2026-04-16/: ADD_FIVUCSAS.md (full ADD), ADD_LANDING_WEBSITE.md, SYSTEM_DESIGN_ANALYSIS_AND_DECISION.md, IDENTITY_CORE_API_ANALYSIS.md (keep-both-services decision), DOCS_MODULE_PROFESSIONAL_DESIGN.md, PLANTUML_DIAGRAMS.md + PLANTUML_DIAGRAMS_PART2.md, BIOMETRIC_FLOW_RESEARCH.md, PGVECTOR_SETUP.md, QUICK_START_PGVECTOR.md, PRESENTATION_COMPLETE_GUIDE.md, PRESENTATION_SPEECHES.md, TASK_LOG_TEMPLATE.md, ANALYTICS_PLAN.md. Plus all numbered reference sections (00-*...09-*), adr/, plans/, diagrams/, README/SECURITY.

Issues filed

None. Every actionable item in the removed docs was confirmed already shipped on HEAD or already covered by the prior org-wide sweep; new issues would be noise for ancient completed work.

Index/link hygiene

Updated 12 KEEP'd README/index files to drop links to removed docs (root README.md, 00-meta/03-development/04-api/05-testing/06-deployment/07-status READMEs, archive/README.md, RUNNING_APPS.md, TEST_QUICKSTART.md, EU_AI_ACT_COMPLIANCE.md, plans/CLIENT_APPS_PARITY.md). Final scan confirms no dangling references to deleted files remain. (Several of those links were already broken pre-PR — e.g. 00-meta pointed at a non-existent module-design/ dir.)

Uncertainties

  • archive/2026-04-16/ANALYTICS_PLAN.md is a near-dup of the live plans/ANALYTICS_PLAN.md (86 vs 57 lines, differing). Kept under "when unsure KEEP" since it is a plan/setup doc, not a report.

Remove 41 dated/disposable tracking documents from the docs book:
- 03-development/IMPLEMENTATION_ROADMAP.md (Oct-2025 MVP roadmap; Koin DI,
  platform token storage, MediaPipe liveness, error mapper, encrypted
  Android storage all verified shipped on client-apps HEAD)
- audits/AUDIT_2026-04-19.md (dated five-team audit; superseded by 2026-06 review wave)
- archive/LOGIN_SURFACES_COMPARISON_2026-04-26.md (dated snapshot)
- archive/2026-04-16/: ADD_* critiques/fix-plans/progress/gap-analyses,
  DOCS_MODULE_* analysis/plan/summary/completion reports, dated status
  reports, pgvector checklist/summary, one-shot review/analysis drafts,
  SCREENSHOTS_NEEDED checklist (~31 files)
- archive/2026-05-28/: 7 dated per-service planning/status snapshots
  (SERVICES_OVERVIEW, test-report, per-module implementation plans)

KEEP (design specs / decision records / diagram sources / research /
setup guides / content artifacts / templates): ADD_FIVUCSAS,
ADD_LANDING_WEBSITE, SYSTEM_DESIGN_ANALYSIS_AND_DECISION,
IDENTITY_CORE_API_ANALYSIS, DOCS_MODULE_PROFESSIONAL_DESIGN,
PLANTUML_DIAGRAMS(+PART2), BIOMETRIC_FLOW_RESEARCH, PGVECTOR_SETUP,
QUICK_START_PGVECTOR, PRESENTATION_COMPLETE_GUIDE, PRESENTATION_SPEECHES,
TASK_LOG_TEMPLATE, ANALYTICS_PLAN — plus all numbered reference sections,
ADRs, plans/, and diagrams.

Update README/index files to drop links to the removed docs.
@ahmetabdullahgultekin ahmetabdullahgultekin merged commit 62efb9f into main Jun 13, 2026
4 of 5 checks passed
@ahmetabdullahgultekin ahmetabdullahgultekin deleted the chore/doc-cleanup-tracking-docs branch June 13, 2026 09:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant