Articles (a/an/the) Trong Văn Bản Kỹ Thuật — Hướng Dẫn Cho Developer

📱 Học IELTS miễn phí: App IELTS 6.0

Giới Thiệu

Bạn đang viết documentation cho API mới. Bạn gõ:

“Send request to server and get response.” 🤔

Có gì sai không? — Thiếu articles! Câu đúng phải là:

✅ “Send a request to the server and get a response.”

Articles (a/an/the) là một trong những lỗi grammar phổ biến nhất của developer Việt Nam khi viết tiếng Anh. Tiếng Việt không có mạo từ, nên não mình hay “quên” chèn a/an/the vào câu. Kết quả? Documentation đọc nghe “lạ”, email thiếu chuyên nghiệp, và đôi khi gây hiểu nhầm.

Bài này giúp bạn nắm quy tắc thực tế để dùng articles đúng trong ngữ cảnh IT — không cần học thuộc lý thuyết dài dòng.

1. Tổng Quan: A, An, The — Khi Nào Dùng Cái Nào?

💡 Quy tắc ngón tay cái: Nếu bạn có thể chỉ vào “cái đó cụ thể” → dùng the. Nếu là “một cái bất kỳ” → dùng a/an. Nếu nói chung chung → không cần article.

2. “A/An” — Khi Nói Về Một Thứ Bất Kỳ

Quy tắc cơ bản

Dùng a/an khi đề cập đến một item chưa xác định cụ thể — lần đầu nhắc đến, hoặc không quan trọng là cái nào.

⚠️ Cẩn thận: Quy tắc a/an dựa trên âm thanh, không phải chữ cái!

Ví dụ trong IT

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

❌ "I found bug in the code."
✅ "I found a bug in the code."

❌ "We need to create database for this project."
✅ "We need to create a database for this project."

❌ "This endpoint returns error when input is invalid."
✅ "This endpoint returns an error when input is invalid."

❌ "She is UI designer on our team."
✅ "She is a UI designer on our team."

📌 Mẹo nhớ: Trong tiếng Việt, bạn nói “Tôi tìm thấy một bug” — chữ “một” đó chính là a/an.

3. “The” — Khi Nói Về Thứ Cụ Thể

Khi nào dùng “the”?

Ví dụ trong Documentation

1
2
3
4
5
6
7
8

✅ "The API accepts JSON payloads."
   (API cụ thể đang document)

✅ "The database schema is defined in schema.sql."
   (Database cụ thể của project)

✅ "The user must authenticate before accessing the dashboard."
   (User cụ thể đang dùng hệ thống)

Pattern phổ biến trong IT

4. Zero Article — Khi Không Cần a/an/the

Khi nào KHÔNG dùng article?

Ví dụ trong IT

1
2
3
4
5
6
7

✅ "JavaScript is a versatile language." (tên riêng → zero article)
✅ "We use Docker for containerization." (tên tool → zero article)
✅ "Software development requires patience." (nói chung → zero article)
✅ "Check your pull request." (your → không cần the)

❌ "The JavaScript is a versatile language."
❌ "We use the Docker for containerization."

⚠️ Ngoại lệ: Khi tên tool được dùng như tính từ: “the Docker container”, “the React component” — ở đây “the” bổ nghĩa cho container/component, không phải cho Docker/React.

5. Articles Trong Các Ngữ Cảnh IT Cụ Thể

5.1 Code Comments

1
2
3
4
5
6
7
8

// ❌ Create connection to database
// ✅ Create a connection to the database

// ❌ Return list of users from API
// ✅ Return a list of users from the API

// ❌ Check if file exists in directory
// ✅ Check if the file exists in the directory

5.2 Commit Messages

Commit messages thường bỏ articles để ngắn gọn — đây là convention được chấp nhận:

1
2
3
4
5
6

✅ "Fix bug in login flow"        (bỏ a/the — OK trong commit)
✅ "Add validation for email field" (bỏ the — OK)
✅ "Update README with new API docs" (bỏ the — OK)

// Nhưng trong description chi tiết, nên viết đầy đủ:
✅ "Fixed a bug where the login flow crashed when the user entered an empty password."

5.3 API Documentation

1
2
3
4
5
6
7
8

❌ "Endpoint returns user object."
✅ "The endpoint returns a user object."

❌ "Pass token in header."
✅ "Pass the token in the Authorization header."

❌ "Request body must contain email field."
✅ "The request body must contain an email field."

5.4 Email Kỹ Thuật

1
2
3
4
5
6
7
8

❌ "I deployed fix to production server."
✅ "I deployed the fix to the production server."

❌ "Can you review PR I submitted?"
✅ "Can you review the PR I submitted?"

❌ "There is issue with database connection."
✅ "There is an issue with the database connection."

5.5 Bug Reports

1
2
3
4
5

❌ "Steps to reproduce: Click button on homepage."
✅ "Steps to reproduce: Click the button on the homepage."

❌ "Expected: System shows error message."
✅ "Expected: The system shows an error message."

6. Bảng Từ Vựng: Articles Với Thuật Ngữ IT Phổ Biến

7. Những Lỗi Phổ Biến Và Cách Sửa

❌ Sai → ✅ Đúng

8. Mẹo Nhanh — Quick Reference Card

📌 5 quy tắc đơn giản cho developer:

🔥 Trick kiểm tra nhanh: Đọc to câu tiếng Việt — nếu bạn nói “một” thì dùng a/an, nếu nói “cái đó” thì dùng the, nếu không cần chỉ định thì bỏ article.

9. Practice — Bài Tập Thực Hành

Bài tập 1: Điền a, an, the, hoặc Ø (zero article)

1. “I created ___ new repository on ___ GitHub.”
2. “___ API returns ___ JSON response.”
3. “We need to set up ___ CI/CD pipeline for ___ project.”
4. “___ developer should always write ___ unit tests.”
5. “Please review ___ code I pushed to ___ staging branch.”
6. “There is ___ issue with ___ database connection.”
7. “___ React is ___ popular frontend framework.”
8. “I fixed ___ bug that ___ QA team reported.”

Đáp án

1. “I created a new repository on Ø GitHub.” (a = một repo mới; GitHub = tên riêng)
2. “The API returns a JSON response.” (the = API cụ thể; a = một response bất kỳ)
3. “We need to set up a CI/CD pipeline for the project.” (a = pipeline mới; the = project đã biết)
4. “A developer should always write Ø unit tests.” (a = một developer bất kỳ; unit tests nói chung)
5. “Please review the code I pushed to the staging branch.” (the = code cụ thể; the = branch cụ thể)
6. “There is an issue with the database connection.” (an = một issue; the = connection cụ thể)
7. “Ø React is a popular frontend framework.” (React = tên riêng; a = một framework)
8. “I fixed the bug that the QA team reported.” (the = bug cụ thể; the = team cụ thể)

Bài tập 2: Sửa lỗi articles trong đoạn văn

“Yesterday I deployed new feature to production server. Feature allows users to upload files. I found bug during testing — system was returning error when file size exceeded limit. I created ticket and assigned it to backend team.”

Đáp án:

“Yesterday I deployed a new feature to the production server. The feature allows users to upload files. I found a bug during testing — the system was returning an error when the file size exceeded the limit. I created a ticket and assigned it to the backend team.”

Kết Luận

Articles nhỏ nhưng tạo sự khác biệt lớn trong cách văn bản kỹ thuật của bạn được đọc. Developer Việt hay bỏ quên a/an/the vì tiếng Việt không có mạo từ — nhưng chỉ cần nhớ 5 quy tắc ở mục 8, bạn đã xử lý được 90% trường hợp.

Mẹo cuối: Sau khi viết xong documentation hay email, đọc lại một lượt và tự hỏi: “Danh từ này cần article không?” — Chỉ cần 30 giây kiểm tra, văn bản sẽ chuyên nghiệp hơn hẳn! ✨

💡 Bài tiếp theo: Prepositions Hay Dùng Sai Trong IT English — Những giới từ mà developer Việt hay nhầm nhất!