Một số coding guideline

Ngày 7 tháng 2 năm 2019

One Band, One Sound

Đó là câu nói của thầy dạy nhạc vài năm trước, khi kiểm điểm lại thái độ làm việc của cả đội Nghi Lễ. Lớn dần, chuyển sang một công việc phải làm việc tập thể thì câu nói ấy vẫn đúng. Mình viết không phải để cho mình đọc, mà để cho đồng nghiệp của mình.

Coding Convention

Coding convention, coding standard, coding guideline,... mấy thứ này cùng nói về một bộ quy tắc chung, được đúc kết trong quá trình làm việc để mọi người tuân thủ nhằm nâng cao chất lượng code.

Vấn đề này, các bạn có thể tìm hiểu định nghĩa ở trên Google, mình chỉ tổng hợp lại một số nguồn để tham khảo quy tắc trong quá trình phát triển phần mềm.

Nếu lười thì bạn có thể xem tại đây: Why Coding Standards Matter.

Một số vấn đề

All code in any code-base should look like a single person typed it, no matter how many people contributed.

Về Design

Về Front-End

Về REST API

Về Microservices

Về Git

Thực tế khi áp dụng

Về coding, mình sử dụng Pretter tích hợp với Visual Studio Code để format lại code nên không quan trọng lắm guideline về cú pháp. Còn lại phải đọc tài liệu để cải thiện kỹ năng. Ngoài ra, bạn có thể sử dụng các công cụ Linter để kiểm tra code trước khi đẩy lên source control. ESLint là một ví dụ.

Về Git, mình dùng Commitizen để tự động nhắc nhở mình phải viết Git Message sao cho chuẩn. Nó cũng có extension tích hợp vào VSCode.

Nên đọc sách gì

Guideline chỉ là quy tắc của một tổ chức để thống nhất với nhau, không nên quá đặt nặng. Có ý thức là được rồi. Tổng quát thì các bạn có thể tham khảo thêm 2 cuốn này để nắm tinh hoa của nó.