# Documentation Index
This folder contains operational and lifecycle documentation for the `gemma3-vllm-stack` repository.

## Files
- `ARCHITECTURE.md`: Component topology, networking, runtime dependencies, and scaling notes.
- `TROUBLESHOOTING.md`: Common failures and copy-paste diagnostics/fixes for ROCm, Docker, vLLM, and UI issues.
- `UPGRADE_NOTES.md`: Safe upgrade, rollback, and backup guidance.

## Recommended reading order
1. `ARCHITECTURE.md`
2. `TROUBLESHOOTING.md`
3. `UPGRADE_NOTES.md`

For quick start and day-1 usage, use the repository root `README.md`.