9b6c585f57
- Updated skill documentation files to include structured metadata for better organization. - Enhanced bilingual descriptions and guidelines for clarity in both English and Vietnamese. - Refined sections on usage, best practices, and related skills to ensure consistency across all documentation. - Improved formatting and removed outdated references to streamline the documentation experience. - Added best practices checklists to relevant skills for better usability and adherence to standards.
Documentation
This directory contains documentation for the GoodGo Microservices Platform, organized by language.
Structure
docs/
├── en/ # English documentation
│ ├── api/
│ ├── architecture/
│ ├── guides/
│ ├── onboarding/
│ ├── runbooks/
│ └── skills/ # Cursor AI skills documentation
├── vi/ # Vietnamese documentation (Tiếng Việt)
│ ├── api/
│ ├── architecture/
│ ├── guides/
│ ├── onboarding/
│ ├── runbooks/
│ └── skills/ # Tài liệu Cursor AI skills
└── README.md # This file
Available Documentation
English (/en)
- API: OpenAPI specifications
- Architecture: System design and service communication patterns
- Guides: Development, deployment, getting started, troubleshooting
- Onboarding: New developer guide
- Runbooks: Incident response and rollback procedures
- Skills: Cursor AI skills documentation (API design, testing, security, etc.)
Vietnamese (/vi)
- API: OpenAPI specifications
- Architecture: Thiết kế hệ thống và các mẫu giao tiếp service
- Guides: Development, deployment, bắt đầu, xử lý sự cố
- Onboarding: Hướng dẫn cho developer mới
- Runbooks: Phản ứng sự cố và quy trình rollback
- Skills: Tài liệu Cursor AI skills (API design, testing, security, v.v.)
Cursor Skills
The project uses Cursor AI Skills to guide AI assistants in following project-specific patterns and standards. See the Skills Documentation for detailed information about each skill:
- API Design - RESTful API standards
- Database & Prisma - Database patterns
- Testing Patterns - Testing best practices
- Code Comments - Bilingual commenting guidelines
- Kubernetes Deployment - K8s deployment patterns
- Observability & Monitoring - Monitoring patterns
- Project Rules - Coding standards
- Security - Security best practices
- Documentation - Documentation guidelines
See Skills Index for complete list and quick reference.
Contributing
When adding new documentation:
- Add the English version to
/en - Add the Vietnamese translation to
/vi - Keep both versions in sync
When updating Cursor Skills:
- Update the skill source file in
.cursor/skills/{skill-name}/SKILL.md - Update the documentation in
docs/en/skills/{skill-name}.mdanddocs/vi/skills/{skill-name}.md - Update the skills index files if needed