mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-06-01 10:31:33 +02:00
Thiên Toán
561c6cbaa3
- Fix untranslated terms in CODE_OF_CONDUCT (witness, criticism, feedback, stalking) - Remove Arabic text accidentally left in Retaliation section - Add missing Scope content to CODE_OF_CONDUCT - Add Vietnamese footers to all module READMEs - Translate footers: Last Updated → Cập Nhật Lần Cuối, Compatible Models → Các Mô Hình Tương Thích - Add missing Vietnamese files: CLAUDE.md, LICENSE, RELEASE_NOTES.md, clean-code-rules.md, resources.md - Add missing images: pr-slash-command.png, memory-*.png, claude-howto-logo.png - Fix CODE_OF_CONDUCT closing message to Vietnamese
111 lines
3.3 KiB
Markdown
111 lines
3.3 KiB
Markdown
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="resources/logos/claude-howto-logo-dark.svg">
|
|
<img alt="Claude How To" src="resources/logos/claude-howto-logo.svg">
|
|
</picture>
|
|
|
|
# Đóng Góp Cho Claude How To / Contributing to Claude How To
|
|
|
|
Cảm ơn bạn quan tâm đến việc đóng góp cho dự án này! Hướng dẫn này sẽ giúp bạn hiểu cách đóng góp hiệu quả.
|
|
|
|
## Về Dự Án Này / About This Project
|
|
|
|
Claude How To là một hướng dẫn trực quan, dựa trên ví dụ cho Claude Code. Chúng tôi cung cấp:
|
|
- **Sơ đồ Mermaid** giải thích cách các tính năng hoạt động
|
|
- **Mẫu sản xuất sẵn** bạn có thể sử dụng ngay lập tức
|
|
- **Ví dụ thực tế** với ngữ cảnh và thực hành tốt nhất
|
|
- **Đường dẫn học tập tiến bộ** từ người mới bắt đầu đến nâng cao
|
|
|
|
## Các Loại Đóng Góp / Types of Contributions
|
|
|
|
### 1. Ví Dụ hoặc Mẫu Mới
|
|
Thêm ví dụ cho các tính năng hiện có (slash commands, skills, hooks, v.v.):
|
|
- Code sẵn sàng để copy-paste
|
|
- Giải thích rõ ràng cách nó hoạt động
|
|
- Các trường hợp sử dụng và lợi ích
|
|
- Mẹo xử lý sự cố
|
|
|
|
### 2. Cải Tiện Tài Liệu
|
|
- Làm rõ các phần nhầm hiểu
|
|
- Sửa lỗi chính tả và ngữ pháp
|
|
- Thêm thông tin còn thiếu
|
|
- Cải thiện các ví dụ code
|
|
|
|
### 3. Hướng Dẫn Tính Năng
|
|
Tạo hướng dẫn cho các tính năng Claude Code mới:
|
|
- Hướng dẫn từng bước
|
|
- Sơ đồ kiến trúc
|
|
- Các mẫu và anti-patterns phổ biến
|
|
- Workflows thực tế
|
|
|
|
### 4. Báo Cáo Lỗi
|
|
Báo cáo các vấn đề bạn gặp phải:
|
|
- Mô tả những gì bạn mong đợi
|
|
- Mô tả những gì thực sự xảy ra
|
|
- Bao gồm các bước để tái tạo
|
|
- Thêm phiên bản Claude Code và OS có liên quan
|
|
|
|
### 5. Feedback và Đề Xuất
|
|
Giúp cải thiện hướng dẫn:
|
|
- Đề xuất giải thích tốt hơn
|
|
- Chỉ ra các khoảng trống trong phạm vi
|
|
- Khuyến nghị các phần mới hoặc tái tổ chức
|
|
|
|
## Bắt Đầu / Getting Started
|
|
|
|
### 1. Fork và Clone
|
|
```bash
|
|
git clone https://github.com/luongnv89/claude-howto.git
|
|
cd claude-howto
|
|
```
|
|
|
|
### 2. Tạo một Nhánh
|
|
Sử dụng tên nhánh mô tả:
|
|
```bash
|
|
git checkout -b add/feature-name
|
|
git checkout -b fix/issue-description
|
|
git checkout -b docs/improvement-area
|
|
```
|
|
|
|
### 3. Thiết Lập Môi Trường Của Bạn
|
|
|
|
Pre-commit hooks chạy cùng các kiểm tra như CI cục bộ trước mỗi commit. Tất cả bốn kiểm tra phải pass trước khi PR được chấp nhận.
|
|
|
|
**Dependencies được yêu cầu:**
|
|
|
|
```bash
|
|
# Python tooling (uv là trình quản lý package cho dự án này)
|
|
pip install uv
|
|
uv venv
|
|
source .venv/bin/activate
|
|
uv pip install -r scripts/requirements-dev.txt
|
|
|
|
# Markdown linter (Node.js)
|
|
npm install -g markdownlint-cli
|
|
|
|
# Mermaid diagram validator (Node.js)
|
|
npm install -g @mermaid-js/mermaid-cli
|
|
|
|
# Install pre-commit và activate hooks
|
|
uv pip install pre-commit
|
|
pre-commit install
|
|
```
|
|
|
|
**Xác minh thiết lập của bạn:**
|
|
|
|
```bash
|
|
pre-commit run --all-files
|
|
```
|
|
|
|
Các hooks chạy trên mỗi commit là:
|
|
- Kiểm tra markdown-lint
|
|
- Kiểm tra cross-references
|
|
- Kiểm tra mermaid-syntax
|
|
- Kiểm tra link-check
|
|
|
|
---
|
|
|
|
Thank you for contributing! 🙏
|
|
|
|
---
|
|
**Cập Nhật Lần Cuối**: Tháng 4 năm 2026
|