To guys who don’t understand Vietnamese: This note is for Vietnamese people who join Math2IT’s translation projects. We translate open-source books/websites about Maths, Information Technology which are helpful for Vietnamese students to learn.

Tùy vào mục đích và bạn biết về Github nhiều hay ít mà hãy chọn mục bên dưới cho phù hợp nhé.

Bạn chỉ muốn góp ý sửa một bài viết nào đó?

  • Dễ nhất: Email trực tiếp đến Math2IT hoặc tác giả đã dịch bài đó để đề nghị sửa.
  • Sửa trực tiếp trên Github: Bạn phải có 1 tài khoản Github, hãy đăng nhập sau đó:
    1. Vào ngay trang chỉnh sửa bài viết đó trên Github (đã được đề cập trong bài dịch), ví dụ bài “Hiểu trực quan chuỗi Taylor thông qua sự liên hệ với ADN”.
    2. Nhấn vào biểu tượng hình cây bút (bên phải nó là biểu tượng hình thùng rác).
    3. Tiến hành sửa theo ý bạn (bạn có thể xóa cái cũ, chúng tôi sẽ tự biết những thay đổi).
    4. Sau khi xóa xong, bạn xuống mục Propose file change, ghi cụ thể cái bạn vừa sửa (khung trên là tên chung - nên ghi ngắn gọn, khung dưới là miêu tả cho chỉnh sửa của bạn - bạn có thể ghi dài)
    5. Sau đó nhấn Propose file change, bạn sẽ chuyển sang một trang khác. Tại đây bạn nhấn vào Create pull request. Điền thông tin cho pull request đó (hoặc để như mặc định cũng được), sau đó nhấn Create pull request.
    6. Chờ chúng tôi xét duyệt và phản hồi bạn.

    Hãy tìm tất cả các lỗi cần sửa và chỉ tạo 1 pull request duy nhất! Tránh tình trạng quá nhiều pull request cho cùng 1 bài viết.

  • Chuyên nghiệp nhưng phức tạp hơn: Làm theo hướng dẫn này để vừa có thể cùng dịch bài, vừa có thể tạo pull request.

Chuẩn chung cho các bài dịch

  1. Luôn kiểm tra bài viết trước khi dịch để tránh tình trạng trùng lặp. Bạn cần TRÁNH các bài đã dịch, đang dịchsắp dịch của dự án. Ví dụ dự án BetterExplained-vn-translation.
  2. Luôn dịch bằng file markdown (.md). Nếu chưa biết nó là gì, hãy xem ở đâyví dụ ở đây.
  3. Gõ Toán học giống gõ trong LaTeX. Đặc biệt, ta dùng $$a+b$$ cho các công thức trong cùng dòng văn bản (inline) thay vì $a+b$ như trong LaTeX. Các công thức khác dòng (display), bạn hãy dùng $$ ở đầu và cuối của block toán, kể cả khi đã dùng \begin{align}...\end{align}. Ví dụ,

    $$
    \begin{align}
    a+b &= c \\
    x+y &= z
    $$
    
  4. Bám sát cấu trúc của bài gốc. Bài gốc dùng heading sao thì trong bài dịch heading y vậy (heading là các đề tựa cho mục).
  5. Chỉ dịch thuật ngữ nếu bạn chắc chắn thuật ngữ đó đã được dùng và công nhận phổ biến. Không tự ý dịch thuật ngữ chưa bao giờ được dịch sang tiếng Việt! Hãy giữ tên gốc hoặc cùng thảo luận trên Group Math2IT!
  6. Không tự ý trang trí cho bài viết mà chưa qua thảo luận với các thành viên khác! Bạn có thể email cho Math2IT hoặc tạo post thảo luận trên Group Math2IT.
  7. Luôn kiểm tra bài viết này thường xuyên để biết các chuẩn mới/đã thay đổi.

Bạn chưa biết gì về Github hay Git và chỉ muốn dịch thôi?

Đọc mục “Chuẩn chung cho các bài viết” trước khi dịch!

Tự dịch một bài nào đó theo chuẩn Markdown, sau đó gởi email cho Math2IT đăng giúp. Chúng tôi sẽ để tên bạn (kèm website nếu bạn cung cấp) vào chỗ người dịch.

Bạn đã biết Github hoặc có chút kiến thức về Git?

Đọc mục “Chuẩn chung cho các bài viết” trước khi dịch!

Làm theo hướng dẫn của bài viết này để clone về máy và tạo các pull request. Nếu vẫn không làm được mà vẫn muốn làm theo cách này, bạn hãy email cho Math2IT hoặc tạo post thảo luận trên Group Math2IT.