mirror of https://github.com/luongnv89/claude-howto.git synced 2026-06-05 22:36:34 +02:00

Files

T

Luong NGUYEN 2230a6ef10 fix(i18n): correct logo image paths in translated root-level files (#124 )

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.

2026-05-20 11:15:36 +02:00

3.3 KiB

Raw Permalink Blame History

Đó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

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ả:

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:

# 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:

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

3.3 KiB Raw Permalink Blame History