Dấu câu không chỉ là hình thức. Nó quyết định nhịp đọc, độ rõ và cảm giác chuyên nghiệp.
Mục tiêu
- Dùng dấu chấm, phẩy, hai chấm đúng cơ bản
- Viết hoa đúng trong email/ticket
- Tránh câu quá dài
Dấu chấm: kết thúc một ý
Weak:
textI checked the logs the error happens after deployment we need to rollback
Better:
textI checked the logs. The error happens after deployment. We may need to roll back.
Dấu phẩy: ngắt cụm ý
textAfter deployment, the payment service started returning 500 errors. If the issue affects more users, we should roll back.
Không lạm dụng dấu phẩy để nối hai câu độc lập:
textThe API failed, we fixed it. ❌ The API failed, and we fixed it. ✅
Dấu hai chấm: giới thiệu list hoặc chi tiết
textWe need to check three items: logs, database connections, and recent config changes.
Viết hoa
Viết hoa:
- đầu câu
- tên riêng: Azure, SQL Server, Vietnam
- acronym: API, HTTP, JSON
Bài tập nhanh
Sửa dấu câu:
textafter the release the api returned 500 we checked logs and found a missing config