video-accessibility/docs/reference/README.md
Vadym Samoilenko a3b300b76a docs: add canonical documentation + audit cleanup
- AGENTS.md: canonical project entry point (Quick Nav, pipeline, constraints)
- docs/: complete docs tree — architecture, API spec, DB schema, infra,
  runbook, requirements, tech stack, principles, reference ADRs, guides,
  tasks backlog, testing strategy
- tests/README.md: test commands, structure, known gaps
- README.md / CLAUDE.md / DEPLOYMENT.md: updated with canonical doc links
- .archive/: backup of pre-documentation-pipeline originals
- backend/uv.lock: uv dependency lockfile
- Delete committed __pycache__ .pyc files (should have been gitignored)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-29 14:22:51 +01:00

46 lines
1.4 KiB
Markdown

# Reference Documentation — Accessible Video Processing Platform
<!-- SCOPE: reference-hub | owner: ln-120 | generated: 2026-04-29 -->
This hub indexes all reference documentation: architectural decisions, how-to guides, operator manuals, and research notes.
---
## Architecture Decision Records (ADRs)
ADRs capture significant architectural decisions, their context, and their trade-offs.
| ADR | Title | Status |
|-----|-------|--------|
| [ADR-001](adrs/2026-04-29-async-celery-bridge.md) | Async Celery bridge via new event loop per task | Accepted |
| [ADR-002](adrs/2026-04-29-jwt-memory-storage.md) | Access tokens stored in JS memory, not localStorage | Accepted |
| [ADR-003](adrs/2026-04-29-hybrid-glossary-retrieval.md) | Hybrid exact + vector glossary retrieval | Accepted |
---
## Guides (Developer How-Tos)
| Guide | Description |
|-------|-------------|
| [testing-strategy.md](guides/testing-strategy.md) | Risk-based testing approach, what to test and how |
---
## Manuals (Operator Procedures)
_No operator manuals yet. Add as operational procedures are formalised._
---
## Research
_No research notes yet. Add technology evaluations as decisions are made._
---
## Maintenance
**Update triggers:** New ADR created, new guide written, research note added.
**Verification:** Every ADR in this index has a corresponding file. No files in subdirectories are missing from the index.
<!-- END SCOPE: reference-hub -->