Repository navigation
v1.2 — Chuẩn hoá hành văn và linter tiếng Việt
Bản này chỉ sửa hành văn và thêm công cụ kiểm. Không thêm, không bớt mục nào; số liệu và kết luận pháp luật giữ nguyên.
Đổi tiêu đề ba chương cho đúng giọng
- Chương 02: "Đừng chết dần" → Đừng để bản thân chết mòn
- Chương 11: "Những vạch đỏ mà người làm kỹ thuật hay vấp" → Những lằn ranh đỏ mà người làm kỹ thuật hay vấp
- Chương 34: "Thuốc trong nhà đừng để ăn hại" → Thuốc trong nhà: đừng để phản tác dụng
Slug file và số chương không đổi, nên mọi link cũ vẫn vào đúng chỗ. Mục lục README và bảng câu hỏi đã sửa theo.
Sửa ngôi xưng
- README: "Việc nào mình đã làm rồi" → "Việc nào bạn đã làm?"
- Trang tự kiểm tra: hai câu đổi từ "mình" sang "bạn" cho khớp phần còn lại của trang.
- Bài dài pháp luật: "việc mình đang gặp" → "tình huống bạn đang gặp".
- Chương 31: "bệnh mãn tính" → "bệnh mạn tính" ở hai chỗ.
Công cụ mới
tools/lint-vi.mjs: quét 34 chương, README, bài dài pháp luật và trang tự kiểm tra. Chặn ở mức ERROR khi gặp thuật ngữ đã cấm, chỉ số nghiên cứu lọt vào "Nói dễ hiểu", sai số thứ tự mục, sai số chương hoặc số mục. Cảnh báo WARN khi câu mở đầu quá 25 từ, câu quá 40 từ, từ viết tắt chưa giải nghĩa, cấu trúc dịch sát. Có--allđể xem hết và--strictnếu muốn không còn cảnh báo nào.tools/test-lint-vi.mjs: ba ca kiểm thử cho chính linter.- Job CI mới "Kiểm văn phong tiếng Việt", chạy cùng bảy job cũ.
STYLEGUIDE.vi.mdthêm checklist trước khi mở PR;docs/vi-find-replace-map.mdghi lại từng chỗ định thay và ngoại lệ.
Trạng thái linter trên toàn sách
37 file, 767 mục: 0 ERROR, 379 WARN. WARN chưa chặn CI vì phần lớn nằm ở nội dung cũ viết từ trước. Đây là danh sách việc cho các lượt biên tập sau, không phải lỗi của bản này.
Đã kiểm
Tám job CI xanh trên commit phát hành: tham chiếu chéo, văn phong, "Nói dễ hiểu", cấu trúc pháp luật, tách câu, số liệu thống kê, trang tự kiểm tra, build. Số mục từng chương không đổi: 47 / 21 / 17 / 13. updates.json khớp.
Còn treo
- Ba sổ kiểm chứng trong
docs/kiem-chung/(chương 02, 11, 34) vẫn ghi tiêu đề cũ. - Chương 31 mục 2: câu nhắc Điều 14 Luật Nghĩa vụ quân sự đã đổi sang "mạn tính", trong khi văn bản luật viết "mãn tính"; ai tra theo chữ trong luật sẽ không khớp.
- 379 WARN chưa xử lý.