2.7 KiB
Documentation Gaps Backlog
This backlog tracks missing documentation discovered during a full docs audit.
High Priority
-
Permissions and RBAC Location:
docs/en/development/permissions-and-rbac.mdReason: Permission model is critical for secure feature development and admin access control. -
Bootstrap Contexts Location:
docs/en/development/bootstrap-contexts.mdReason: Runtime contexts (ADMIN, STREAM, CLI, MINIMAL) affect behavior and initialization. -
HTTP Request Handling and Middleware Location:
docs/en/development/http-request-handling.mdReason: Request validation and middleware flow are central for new controllers and APIs. -
Error Handling Model Location:
docs/en/development/error-handling.mdReason: Error lifecycle and error codes are referenced in architecture but not documented for contributors. -
Input Validation Strategy Location:
docs/en/development/input-validation.mdReason: Validation rules and usage patterns are required to avoid inconsistent endpoint behavior. -
Authentication and Sessions Location:
docs/en/development/authentication-and-sessions.mdReason: Auth/session flow is security-sensitive and currently under-documented.
Medium Priority
-
Streaming Subsystem Overview Location:
docs/en/development/streaming-subsystem.mdReason: Streaming hot path and boundary points are spread across architecture docs only. -
Event Catalog and Module Hooks Location:
docs/en/development/modules.md(expand) Reason: Event-driven extensions need a complete event list and payload guidance. -
Caching and Redis Strategy Location:
docs/en/development/caching-and-redis.mdReason: Cache usage and invalidation patterns are not centralized. -
Reseller System Overview Location:
docs/en/administration/reseller-system.mdReason: Reseller workflows are core functionality but lack dedicated docs. -
Backup Strategy Location:
docs/en/administration/backup-strategy.mdReason: Operational safety depends on consistent backup guidance. -
GeoIP and Device Detection Location:
docs/en/development/geoip-and-device-detection.mdReason: Region/device behavior impacts stream logic and access control.
Low Priority
-
Process Management Patterns Location:
docs/en/development/process-management.mdReason: Useful for daemon and background processing contributions. -
Development Feature Flags Location:
docs/en/development/feature-flags.mdReason: Clarifies behavior differences across environments. -
Diagnostics Service Notes Location:
docs/en/development/diagnostics-api.mdReason: Improves troubleshooting and support workflow.
Notes
- This backlog lists missing docs only.
- It does not change architecture behavior.
- Update this file as gaps are addressed.