Hướng dẫn cho người mới bắt đầu
Cảm ơn bạn đã quan tâm đến việc đóng góp! Trang này giải thích những điều cần biết khi tham gia đóng góp.
Hãy chú ý đến đối tượng độc giả
Hãy hình dung đối tượng độc giả được mô tả trong phần "Giới thiệu" - "Cuốn sách này viết cho ai?" và viết với mức độ phù hợp cho họ.
📄️ Trang chủ
Nhập môn TypeScript "Survival TypeScript" - Những điều tối thiểu cần nắm vững khi sử dụng trong thực tế
Người mới hoàn toàn chưa biết lập trình không phải là đối tượng mục tiêu, nên những khái niệm quá cơ bản như "biến là gì", "hàm là gì" sẽ được bỏ qua. Tuy nhiên, có thể họ biết khái niệm biến từ ngôn ngữ khác nhưng chưa biết cú pháp khai báo biến trong JavaScript. Vì vậy, hãy hình dung một lập trình viên có kinh nghiệm nhưng có thể chưa biết JavaScript.
Hãy tuân theo văn phong và style
Văn phong cơ bản được quy định tại trang sau:
📄️ Văn phong và style
Hướng dẫn về văn phong để đảm bảo tính nhất quán trong bản dịch.
Hãy thống nhất thuật ngữ
Hãy chú ý để tránh sự không nhất quán trong cách sử dụng thuật ngữ. Hãy cố gắng thống nhất với các thuật ngữ đã có. Không cần quá căng thẳng, chỉ cần chú ý trong phạm vi có thể. Sau đó ai đó có thể tìm và sửa.
Các thuật ngữ tiếng Anh có quy định nhất định:
📄️ Bảng thuật ngữ Anh-Việt
Trong bản dịch này, các thuật ngữ chuyên môn sẽ được giữ nguyên tiếng Anh để đảm bảo tính nhất quán với tài liệu gốc và dễ tra cứu. Dưới đây là danh sách các thuật ngữ thường gặp:
Hãy thảo luận trước khi tạo Pull Request
Nguyên tắc cộng tác của dự án này là "thảo luận trước khi tạo PR". Khi tìm thấy điểm cần cải thiện, đừng bắt đầu ngay mà hãy thảo luận trong issue trước. Chi tiết xem tại:
📄️ Quy trình làm việc (Thảo luận trước khi tạo PR)
Quy trình làm việc - thảo luận trước khi tạo Pull Request.
Hãy công khai dù chưa hoàn thành
Bạn có thể tạo Pull Request ngay cả khi chưa viết xong. Thông tin một phần vẫn hữu ích hơn là không có thông tin gì.
Quy trình từ cài đặt đến Pull Request
Chi tiết quy trình từ cài đặt môi trường đến tạo Pull Request xem tại:
📄️ Quy trình từ cài đặt đến Pull Request
Trang này giải thích quy trình từ cài đặt môi trường đến tạo Pull Request.