Ngày 21/06/2025, tôi đã hoàn thành chứng chỉ Creating Effective Documentation for Developers (LFC112) từ The Linux Foundation. Đây là một trải nghiệm thú vị và bổ ích, bởi viết tài liệu không chỉ là kỹ năng phụ trợ, mà thực chất là một phần không thể thiếu để xây dựng sản phẩm và hệ thống phần mềm chất lượng.
Trong nhiều năm làm việc với vai trò backend developer, technical manager và CTO, tôi thường xuyên thấy các dự án thất bại hoặc bị trì hoãn không phải vì thiếu code, mà vì thiếu tài liệu rõ ràng. Một hệ thống phức tạp nhưng không có hướng dẫn sử dụng, không có kiến trúc giải thích, hay không có API docs chuẩn mực sẽ rất khó mở rộng, bàn giao hoặc duy trì.
Chứng chỉ LFC112 giúp tôi học được:
- Nguyên tắc viết tài liệu rõ ràng, chính xác, dễ hiểu.
- Cách viết tài liệu dành cho nhiều đối tượng khác nhau: developer, tester, end-user, hay quản lý.
- Best practices khi xây dựng API documentation, system design docs, và how-to guides.
- Công cụ và định dạng phổ biến (Markdown, reStructuredText, Sphinx, Docs-as-Code).
Quá trình học và chuẩn bị
Tôi đã dành khoảng 1 tuần để học và thực hành:
- Đọc tài liệu chính thức và làm bài tập đi kèm trong khóa học.
- Viết lại tài liệu cho dự án cá nhân bằng Markdown và cấu trúc lại theo chuẩn Docs-as-Code.
- Tham khảo tài liệu open source (Linux kernel, Kubernetes, Terraform) để rút kinh nghiệm về cách họ viết docs.
Cảm nhận về chứng chỉ
- Độ khó: Không quá nặng về kỹ thuật, nhưng yêu cầu sự tỉ mỉ và tư duy hệ thống.
- Điểm thú vị: Học cách nhìn tài liệu như một sản phẩm – cần được thiết kế, maintain và cập nhật liên tục.
- Ứng dụng ngay lập tức: Sau khi học xong, tôi đã áp dụng vào việc viết guideline nội bộ cho team, và thấy hiệu quả rõ rệt khi onboarding thành viên mới.
Giá trị mang lại
- Cá nhân: Nâng cao kỹ năng viết, giúp tôi truyền đạt ý tưởng kỹ thuật một cách mạch lạc.
- Đội ngũ: Giảm thời gian onboarding, giảm hiểu lầm giữa các team (dev, QA, BA).
- Doanh nghiệp: Dự án có tài liệu tốt giúp dễ dàng bàn giao, kiểm thử và mở rộng.
Bước tiếp theo
- Kết hợp kỹ năng viết tài liệu với các chứng chỉ đã đạt trước đó như Secure Software (LFD121) và Green Software (LFC131) để xây dựng guideline toàn diện hơn.
- Tham gia đóng góp vào tài liệu của các dự án open source.
- Xây dựng chuẩn Documentation-as-Code cho nội bộ công ty.
Kết luận
Chứng chỉ LFC112 cho tôi nhận ra rằng: code có thể giải quyết vấn đề, nhưng tài liệu mới giúp giải pháp đó lan tỏa và duy trì lâu dài. Đây là một kỹ năng mà bất kỳ developer hay leader nào cũng nên trau dồi. full-width
👉 Nếu bạn từng xem việc viết tài liệu là việc phụ, hãy thử nhìn lại. Một tài liệu tốt có thể tiết kiệm hàng trăm giờ làm việc và giảm đáng kể rủi ro trong dự án.
Đăng nhận xét