jobtrackingapp/docs/documentation-rules.md

Documentation rules

Current documentation describes verified repository behavior or clearly labels future work. Use one authoritative guide per subject and link to it rather than copying long sections.

• docs/README.md is the entry point.
• docs/architecture/overview.md is the current system summary.
• docs/configuration/environment-variables.md is the environment-variable index.
• docs/roadmap/ contains open work, debt, and known issues.
• BLOCKERS.md contains operator/external dependencies referenced by repository instructions.
• docs/_archive/ is historical evidence and is not authoritative.

Update behavior documentation in the same change as code. Do not put secrets, private user data, or temporary AI/planning transcripts in active documentation.