Developer
070cd4d5a5
Add generated .pi-map.md and .pi-map.index.md files across the repository so the project navigation maps are shared and versioned. These artifacts are maintained by project_map_init/patch/validate and must be kept in sync with source edits. Note: .cache/ remains ignored (added in previous commit).
1.3 KiB
1.3 KiB
openspec/changes/archive/2026-05-19-api-documentation
dir: openspec/changes/archive/2026-05-19-api-documentation
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
role
Planning and design documents for a comprehensive API documentation improvement initiative targeting a FastAPI-based application.
files
- design.md | Design document outlining API documentation structure, health endpoints, and OpenAPI enhancements for a FastAPI-based application | dep: FastAPI, Pydantic v2, psutil, SQLAlchemy, PostgreSQL, Docker
- proposal.md | Proposes a comprehensive API documentation improvement plan for a FastAPI-based project | dep: FastAPI, OpenAPI/Swagger, ReDoc, Pydantic, apps/api/README.md, docs/architecture/decisions/
- tasks.md | Project task tracking document for API documentation improvements across health endpoints, endpoint documentation, model documentation, README creation, architecture decisions, and quality gates
arch
Document-driven planning architecture with three-tier separation: design specifications (design.md), strategic proposals (proposal.md), and task tracking/execution planning (tasks.md), organized by date-based archival structure for change management.
tags
documentation, api, fastapi, design, document, health, endpoints, openapi