4 Commits

Author SHA1 Message Date
0sm0s1z 6d029c31a2 docs: add comprehensive developer guide and update documentation
- Add README.developer-guide.md with complete development workflows
- Add QUICK-REFERENCE.md for common commands and troubleshooting
- Update README.docker-architecture.md with new environment switching
- Update README.development.md to reference new developer guide
- Update documentation index to include all files
- Document new image tagging strategy and environment switching
- Provide comprehensive troubleshooting and best practices
- Include quick reference for common development tasks
2025-10-03 18:44:35 -07:00
0sm0s1z 44a51a89a8 feat(docker): implement proper environment switching with distinct image tags
- Add environment-specific image tags (dev, prod) to prevent cache conflicts
- Update docker-compose.dev.yaml to use sirius-sirius-ui:dev tag
- Update docker-compose.prod.yaml to use sirius-sirius-ui:prod tag
- Create scripts/switch-env.sh for convenient environment switching
- Script handles cleanup, rebuild, and proper environment startup
- Resolves issue where cached images prevented dev/prod mode switching
- Now supports seamless switching between development and production modes
2025-10-03 18:37:37 -07:00
0sm0s1z d2b22e3a02 docs(docker): add comprehensive troubleshooting for Docker layer caching issues
- Add detailed section on Docker layer caching problems that cause dev images in prod
- Include symptoms, root cause analysis, and step-by-step solutions
- Add verification steps to ensure correct build targets are used
- Include prevention strategies and long-term best practices
- Add environment switching best practices to prevent cache issues
- Document the specific React hook error case we encountered
- Provide immediate fix commands and verification steps
2025-10-03 18:18:26 -07:00
0sm0s1z 33e202b0bf feat: complete documentation system overhaul and Docker architecture
- Create comprehensive documentation system with templates and standards
- Add Docker architecture documentation with complete setup guide
- Implement documentation testing and validation system
- Simplify git operations workflow for practical development
- Reorganize documentation structure with proper categorization
- Add container testing system with Makefile integration
- Archive old documentation and consolidate new structure
- Update cursor rules for documentation and testing workflows
- Fix Makefile paths for documentation linting scripts
- Add Docker architecture doc to documentation index
2025-10-03 17:31:05 -07:00