Commit Graph

1 Commits

Author SHA1 Message Date
juanatsap 025c10ac1f docs: Add comprehensive backend handler documentation
Create public-facing documentation explaining backend architecture:

New Documentation:
- doc/14-BACKEND-HANDLERS.md (900+ lines)
  * Handler architecture and file organization
  * Request/response type system with examples
  * Middleware pattern and preferences handling
  * Comprehensive testing strategy
  * Data flow diagrams and best practices
  * Code examples for all major patterns

Updated:
- doc/README.md
  * Add Backend Handlers to technical implementation section
  * Update total active docs count (13 → 14)
  * Add quick navigation links

Content Coverage:
- Handler responsibilities (pages, PDF, HTMX)
- Type-safe request handling with validation
- Middleware architecture and context usage
- Test coverage across all handler types
- Request processing flow diagrams
- Best practices with do/don't examples

Audience:
- Backend developers
- API consumers
- New contributors
- Technical documentation readers

Complements:
- Educational docs in _go-learning/refactorings/
- Internal architecture documentation
- API reference guide
2025-11-20 17:35:58 +00:00