Github: https://github.com/minhhungit/designpatternsincsharptiengviet
Gitbook: https://minhhungit.gitbook.io/designpatternsincsharptiengviet
Project này là bản dịch các Design Patterns (mẫu thiết kế) dựa trên khung sườn của cuốn sách Design Patterns in C# - tác giả Vaskaran Sarcar, với mong muốn giúp các bạn developer .NET Việt Nam (hoặc thậm chí ngôn ngữ khác, nước khác ^^ ) tiếp cận dễ dàng hơn các mẫu thiết kế.
Lưu ý: việc dịch dựa trên sách Design Patterns in C# này không có nghĩa nội dung được dịch hoàn toàn 100%, sách cũng chỉ được sử dụng với mục đích tham khảo, người dịch có thể thêm thắt, lượt bỏ, đưa thêm ví dụ, viện dẫn các nguồn, bài viết khác nhau nhằm mục đích giải thích cho người đọc hiểu được lý do tại sao mẫu thiết kế được tạo ra, làm thế nào để sử dụng cũng như nên sử dụng trong những trường hợp cụ thể nào.
Mọi đóng góp dù lớn hay nhỏ cũng đều được hoan nghênh.
Để tham gia đóng góp bản dịch cho các mẫu thiết kế, các bạn chỉ cần làm theo các bước sau:
- Đăng ký chương mà bán muốn dịch tại đây nhằm tránh trùng lặp (nhiều người cùng dịch)
- Fork repo này
- Update file .md create và pull request để merge
Vì project này chỉ mới được bắt đầu, chúng ta sẽ tập trung vào các chương chưa dịch thay vì chỉnh sửa các /chương đã dịch xong (tuy vậy, nếu có sai sót gì nghiêm trọng ở các chương đã dịch, rất hoan nghênh sự đóng góp của các bạn). Để bắt đầu dịch một chương mới, vui lòng thực hiện theo quy ước sau:
- Chỉ dịch một chương cho mỗi PR (pull request)
- Trước khi bắt tay vào dịch một chương, hãy kiểm tra xem chương đó có ai đã hoặc đang dịch hay không, xem tại đây.
- Tạo một branch mới từ master với tên là chương bạn muốn dịch, ví dụ
chuong-02-abc-xyz - Tạo một thay đổi nhỏ để submit PR vào master, với tên PR là [WIP] Chương 02: ABC XYZ (WIP nghĩa là Work In Progress - đang dịch)
- Tiến hành dịch dưới local và push commit vào PR này
- Sau khi phần dịch đã hoàn tất, xóa cụm [WIP] khỏi tên PR và tag một hay vài thành viên chính vào PR
Do sự khác biệt về ngôn ngữ và những đặc thù của tiếng Việt, sẽ có những khó khăn nhất định khi dịch. Vì vậy, có một số lưu ý như sau:
-
Không nhất thiết phải dịch toàn bộ từ hoặc cụm từ sang tiếng Việt, nhất là những từ chuyên ngành (framework, file, component…) Đối với những từ dịch được nhưng nghe lạ tai trong tiếng Việt, hãy dùng quy ước tiếng Anh (nghĩa tiếng Việt) cho lần đầu tiên, và dùng tiếng Anh từ đó về sau. Ví dụ:
Singleton pattern (mẫu thiết kế Singleton) là một trong những mẫu thiết kế đơn giản nhất. Singleton pattern được nhóm trong nhóm Creational patterns (Nhóm Khởi tạo), cung cấp một trong những cách tốt nhất để tạo object...
-
Đối với những từ hoặc cụm từ hoàn toàn không có từ ngữ tương đương trong tiếng Việt, hãy thông báo để chúng ta cùng thảo luận.
-
Không nhất thiết phải dịch 1:1. Đôi khi chúng ta nên thêm hoặc bớt vài từ hoặc thậm chí là cả một câu để bản dịch được tự nhiên hơn, miễn là truyền tải được đúng và đủ ý.
Đang cập nhật...