Dịch tài liệu phần mềm cần giữ nguyên thuật ngữ nào? Đây là câu hỏi quan trọng vì một từ được dịch quá mức có thể làm người dùng không tìm thấy nút bấm, không chạy được lệnh hoặc hiểu sai hướng dẫn tích hợp. Ngược lại, để nguyên quá nhiều tiếng Anh lại khiến tài liệu khó tiếp cận với người đọc phổ thông.
Nguyên tắc thực tế là giữ nguyên những yếu tố cần được nhận diện hoặc nhập chính xác; chỉ dịch phần giải thích, ngữ cảnh và nội dung hướng dẫn. Một quy ước thuật ngữ rõ ràng từ đầu sẽ giúp tài liệu nhất quán giữa hướng dẫn sử dụng, tài liệu API, ghi chú phát hành và nội dung hỗ trợ kỹ thuật.
Vì sao cần xác định thuật ngữ giữ nguyên trước khi dịch?
Tài liệu phần mềm không chỉ có văn bản mô tả mà còn chứa các thành phần để người dùng thao tác trực tiếp: tên màn hình, nút lệnh, trường dữ liệu, tên tệp, đoạn mã và định danh kỹ thuật. Nếu các thành phần này bị chuyển ngữ tùy tiện, người đọc có thể không đối chiếu được với sản phẩm thực tế.
Việc giữ nguyên thuật ngữ còn hỗ trợ tìm kiếm. Người dùng thường tra cứu lỗi, cấu hình hoặc cách sử dụng bằng đúng tên tính năng và chuỗi thông báo đang xuất hiện trên hệ thống. Vì vậy, bản dịch nên cân bằng giữa khả năng đọc hiểu bằng tiếng Việt với khả năng nhận diện chính xác thuật ngữ gốc.
Trước khi triển khai, nên lập bảng thuật ngữ gồm dạng viết chuẩn, bản dịch được phép dùng, trường hợp phải giữ nguyên và cách trình bày khi thuật ngữ xuất hiện lần đầu. Bảng này đặc biệt hữu ích khi nhiều người cùng dịch hoặc tài liệu được cập nhật thường xuyên.
Tên riêng, tên sản phẩm và định danh nên để nguyên
Tên riêng thường không nên dịch vì chúng là dấu hiệu nhận biết, không phải nội dung cần diễn giải. Nhóm này có thể bao gồm tên sản phẩm, mô-đun, gói chức năng, tên dự án, tên dịch vụ, tên môi trường triển khai và tên tài khoản mẫu nếu tài liệu quy định cụ thể.
Cũng nên giữ nguyên các định danh có tính duy nhất, chẳng hạn mã lỗi, mã sự kiện, mã yêu cầu, mã phiên bản, mã cấu hình hoặc khóa nhận diện. Dịch các chuỗi này có thể làm sai lệch kết quả khi người dùng sao chép, tìm kiếm trong nhật ký hệ thống hoặc trao đổi với bộ phận kỹ thuật.
Với một tên tính năng khó hiểu, có thể giữ nguyên tên gốc rồi giải thích bằng tiếng Việt ở lần xuất hiện đầu tiên. Cách này vừa giúp người đọc nắm được ý nghĩa, vừa tạo được điểm đối chiếu với giao diện và tài liệu liên quan.
Dịch tài liệu phần mềm cần giữ nguyên thuật ngữ nào trong mã và cấu hình?
Các nội dung mà người dùng cần sao chép, dán hoặc nhập vào hệ thống gần như luôn phải được bảo toàn nguyên dạng. Bao gồm tên biến, tên hàm, tên lớp, tên phương thức, tham số, giá trị cấu hình, câu lệnh, biểu thức, tên cơ sở dữ liệu, tên bảng và tên cột.
Đường dẫn tệp, URL, địa chỉ máy chủ, tên miền, tên thư mục, phần mở rộng tệp và khóa cấu hình cũng không nên dịch. Chỉ một thay đổi nhỏ về dấu cách, chữ hoa chữ thường hoặc ký tự đặc biệt có thể khiến hướng dẫn không còn thực hiện được.
Khi mô tả mã, nên dịch phần lời dẫn thay vì sửa nội dung kỹ thuật. Ví dụ, có thể viết “thay giá trị của tham số” nhưng giữ nguyên tên tham số trong đoạn mã. Nếu cần chú thích, đặt giải thích bên ngoài chuỗi lệnh để tránh khiến người đọc nhầm rằng chú thích cũng phải được nhập.
- Giữ nguyên cú pháp và ký tự đặc biệt trong lệnh.
- Không Việt hóa tên tệp, tên thư mục hoặc giá trị cấu hình minh họa.
- Bảo toàn định dạng để người đọc dễ sao chép chính xác.
API, chuẩn kỹ thuật và từ viết tắt cần xử lý nhất quán
Tên API, endpoint, giao thức, định dạng dữ liệu, thuật toán, ngôn ngữ lập trình và chuẩn kỹ thuật nên được giữ nguyên. Đây là những thuật ngữ có cách gọi đã được dùng trong tài liệu kỹ thuật, công cụ phát triển và cộng đồng chuyên môn.
Đối với từ viết tắt, nên xác định người đọc mục tiêu. Nếu tài liệu dành cho lập trình viên hoặc quản trị viên, có thể giữ nguyên từ viết tắt và diễn giải ngắn ở lần đầu xuất hiện khi cần. Nếu tài liệu dành cho người dùng nghiệp vụ, phần giải thích nên rõ hơn, nhưng vẫn không nên tự đổi từ viết tắt thành một chuỗi tiếng Việt mới khiến việc tra cứu trở nên khó khăn.
Các đơn vị kỹ thuật, tên kiểu dữ liệu, trạng thái hệ thống và mức phân quyền cũng cần được thống nhất. Không nên dịch một thuật ngữ theo nhiều cách trong cùng tài liệu, ví dụ lúc gọi là “quyền truy cập”, lúc lại gọi là “quyền hạn”, nếu hai cách này đang chỉ cùng một khái niệm trong sản phẩm.
Tên nút bấm và chuỗi giao diện không phải lúc nào cũng giữ nguyên
Chuỗi giao diện là nhóm cần xem xét theo phiên bản sản phẩm mà tài liệu đang hướng dẫn. Nếu giao diện đã được Việt hóa, tên nút, menu, hộp thoại và thông báo nên khớp chính xác với bản tiếng Việt mà người dùng nhìn thấy. Trong trường hợp đó, giữ nguyên tiếng Anh có thể gây khó thao tác.
Nếu sản phẩm chỉ có giao diện tiếng Anh, nên giữ nguyên nhãn giao diện để người dùng tìm đúng vị trí. Phần hướng dẫn xung quanh vẫn được dịch sang tiếng Việt. Có thể trình bày theo dạng: chọn Save để lưu, hoặc mở menu Settings để thay đổi thiết lập.
Với tài liệu phục vụ nhiều ngôn ngữ giao diện, cách an toàn là nêu nhãn gốc kèm diễn giải tiếng Việt ở lần đầu: Export (xuất dữ liệu). Tuy nhiên, cần áp dụng nhất quán và tránh chèn song ngữ dày đặc làm câu hướng dẫn khó đọc.
Thiết lập quy tắc biên tập để hạn chế nhầm lẫn
Một quy trình rà soát tốt nên tách rõ phần cần dịch và phần phải bảo toàn. Người dịch có thể đánh dấu các chuỗi kỹ thuật ngay từ đầu; người hiệu đính sau đó kiểm tra lại sự nhất quán của tên gọi, chữ hoa chữ thường, dấu câu và định dạng.
Bảng dưới đây là gợi ý phân loại nhanh:
| Nhóm nội dung | Cách xử lý thường dùng |
|---|---|
| Tên sản phẩm, mô-đun, mã lỗi | Giữ nguyên |
| Lệnh, mã nguồn, đường dẫn, tham số | Giữ nguyên tuyệt đối |
| API, giao thức, chuẩn kỹ thuật | Giữ nguyên, giải thích khi cần |
| Nhãn nút và menu | Theo đúng ngôn ngữ của giao diện được hướng dẫn |
| Khái niệm nghiệp vụ, mô tả thao tác | Dịch tự nhiên và thống nhất |
Ngoài bảng thuật ngữ, nên duy trì danh sách các chuỗi không được chỉnh sửa. Khi tài liệu có ảnh chụp giao diện hoặc ví dụ thao tác, nội dung bản dịch cần đối chiếu với phiên bản sản phẩm tương ứng để tránh tình trạng tên gọi trong bài và trên màn hình không trùng nhau.
Câu hỏi thường gặp
Có nên dịch tên nút bấm trong tài liệu phần mềm không?
Nên dùng đúng tên đang hiển thị trên giao diện mà tài liệu hướng dẫn. Nếu giao diện là tiếng Anh, thường giữ nguyên nhãn tiếng Anh.
Tên API có cần dịch sang tiếng Việt không?
Không nên dịch tên API, endpoint, tham số và các chuỗi kỹ thuật. Có thể thêm phần giải thích tiếng Việt bên cạnh khi cần.
Có được dịch mã lỗi không?
Không. Mã lỗi nên được giữ nguyên để người dùng tìm kiếm, đối chiếu nhật ký và báo lỗi chính xác.
Tên tệp và đường dẫn có thể Việt hóa không?
Không nên. Tên tệp, đường dẫn, phần mở rộng và chuỗi cấu hình cần được bảo toàn để tránh lỗi thao tác.
Làm sao tránh dịch thuật ngữ không nhất quán?
Hãy lập bảng thuật ngữ và danh sách chuỗi không được sửa trước khi dịch, rồi dùng chúng trong toàn bộ quá trình biên dịch và hiệu đính.
