mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-07-11 23:26:32 +02:00
Luong NGUYEN
2230a6ef10
Follow-up to #123 — that PR fixed module README logo paths but missed root-level translated files (README, INDEX, CATALOG, CONTRIBUTING, STYLE_GUIDE, etc.) which had the same broken-path pattern: they used `resources/logos/...` (root-relative) but live one directory deep, so they resolved to `{lang}/resources/logos/...` and 404'd. Fix: `resources/logos/...` → `../resources/logos/...` in the top `<picture>` block of each translated root-level file. For STYLE_GUIDE files, the in-code-fence `<picture>` example was left as `resources/logos/...` to mirror the English source — it documents the canonical pattern, not the path the file itself uses. Files: zh/ (×9), uk/ (×4), vi/ (×2). ja/STYLE_GUIDE.md was already correct.
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
|