💼 Người đi làm›cho dân IT Ngữ pháp·Trung cấp
Ngữ pháp tiếng Anh trong giao tiếp IT: Viết Commit Message, Pull Request và Ticket
Hướng dẫn sử dụng cấu trúc ngữ pháp chuẩn xác và chuyên nghiệp khi viết commit message, mô tả Pull Request (PR) và Jira ticket trong môi trường phát triển phần mềm.
1. Những câu hỏi thường gặp khi viết trao đổi kỹ thuật (Commit, PR, Ticket)
Câu hỏi 1: Tại sao thông điệp đẩy mã (Commit Message) luôn dùng câu mệnh lệnh (Imperative Mood) thay vì quá khứ?
Trong quy chuẩn làm việc tại các công ty phần mềm quốc tế, thông điệp đẩy mã được coi như một câu lệnh hướng dẫn Git thực hiện thay đổi. Do đó, câu mệnh lệnh ở thì hiện tại đơn dạng nguyên mẫu (Infinitive verb without 'to') là chuẩn mực bắt buộc.
- Nên dùng: Add email validation to registration form. (Thêm xác thực email vào biểu mẫu đăng ký.)
- Không nên dùng: Added email validation... (Đã thêm...) hoặc Adding email validation... (Đang thêm...)
Câu hỏi 2: Cấu trúc ngữ pháp chuẩn khi trình bày một mô tả công việc (Pull Request Description) là gì?
Một bài mô tả công việc tiêu chuẩn thường chia làm ba phần chính với các cấu trúc ngữ pháp ngắn gọn, trực diện:
- Mục đích (What/Why): Dùng thì hiện tại đơn ở thể chủ động để nêu chức năng của đoạn mã. Ví dụ: This PR resolves the memory usage issue during file upload. (PR này xử lý vấn đề tiêu tốn bộ nhớ khi tải tệp lên.)
- Các thay đổi chính (Changes): Dùng danh sách kết hợp động từ nguyên mẫu hoặc danh từ. Ví dụ: Update payment gateway integration. (Cập nhật tích hợp cổng thanh toán.)
- Hướng dẫn thử nghiệm (How to test): Dùng câu mệnh lệnh theo từng bước cụ thể. Ví dụ: Navigate to settings, then click 'Save'. (Di chuyển đến phần cài đặt, sau đó nhấn 'Lưu'.)
Câu hỏi 3: Làm thế nào để mô tả lỗi (Ticket/Bug report) vừa lịch sự vừa rõ ràng ngữ pháp?
Khi báo lỗi trên hệ thống quản lý công việc, người làm công nghệ thường kết hợp thì hiện tại đơn (mô tả hành vi hiện tại) và câu điều kiện/kết quả kỳ vọng (Expected behavior):
blockquote>When the user submits the form, the system crashes instead of showing a confirmation message.
(Khi người dùng gửi biểu mẫu, hệ thống gặp sự cố thay vì hiển thị thông báo xác nhận.)
2. Bảng tổng hợp các cấu trúc hay dùng
| Mục đích | Cấu trúc ngữ pháp mẫu | Ví dụ thực tế |
|---|---|---|
| Commit Message | [Imperative Verb] + [Object] | Fix login failure on mobile devices. (Sửa lỗi đăng nhập trên thiết bị di động.) |
| Yêu cầu sửa mã (PR Review) | Could you please + [Verb]? / Please + [Verb] | Could you please revert this commit? (Bạn có thể hoàn tác lần đẩy mã này không?) |
| Báo cáo lỗi (Ticket) | [Subject] + fails to / is unable to + [Verb] | The database fails to populate user preferences. (Cơ sở dữ liệu không thể điền sở thích người dùng.) |
3. Lưu ý lỗi người Việt thường mắc
Khi giao tiếp qua văn bản trong dự án phần mềm, lập trình viên Việt Nam thường gặp một số sai sót ngữ pháp phổ biến:
- Lỗi chia thì quá khứ cho Commit Message: Quen tay viết Fixed bug, Updated API thay vì Fix bug, Update API.
- Lỗi dịch thô từ tiếng Việt (Word-by-word): Dùng câu không có chủ ngữ rõ ràng như Cannot click button (thiếu chủ ngữ The user hoặc The system). Hãy viết chuẩn: Users cannot click the submit button.
- Dùng sai từ loại: Dùng tính từ hoặc danh từ sai vị trí khi đặt tiêu đề thẻ công việc. Ví dụ viết Enhancement user UI thay vì Enhance user UI hoặc UI Enhancement.
