Aldinei Bastos (Pinei)

Kiểm tra và sửa các cách sử dụng ký hiệu $ thực tế trong nội dung Markdown.

Các ký hiệu $ được chia thành ba nhóm:

- Tiền tệ (cần thêm ký tự thoát - escape cho nhóm này) — $1, $2 billion, R$ 549 → các cặp ký hiệu này là nguyên nhân gây ra toàn bộ cảnh báo lỗi
- Công thức toán học thực sự (giữ nguyên) — $\rightarrow$, $O(1)\text{ streaming}$ → hợp lệ, không gây cảnh báo
- Mã lệnh Shell (giữ nguyên) — $(curl…), ZSH_CUSTOM, $HOME → nằm bên trong các khối mã (code blocks)


Thực hiện theo 4 bước:

- Điều tra (Investigate) — tìm kiếm (grep) trong nội dung, phân loại mọi ký hiệu $ vào nhóm tiền tệ / toán học thực sự / mã lệnh shell, và báo cáo số lượng trước khi thay đổi bất kỳ thứ gì.
- Áp dụng (Apply) — kiểm tra xem cây thư mục mã nguồn có đang sạch (clean) hay không, sau đó viết và chạy đúng kịch bản Python đã được kiểm thử (nhận biết được code fence, inline code, frontmatter và vùng công thức toán; đảm bảo tính lũy đẳng idempotent thông qua biểu thức lookbehind (?<!\\) để việc chạy lại không bao giờ làm escape chồng hai lần).
- Xác minh bản so sánh thay đổi (Verify the diff) — lưới an toàn: chạy các lệnh grep mà kết quả bắt buộc phải trống đối với công thức toán thực sự ($\rightarrow$, \text) và các biến shell ($HOME, $(…), VAR). Nếu bất kỳ nội dung hợp lệ nào bị chạm tới, hãy báo cho người dùng chạy lệnh git checkout -- . và dừng lại ngay.
- In hướng dẫn (Print instructions) — xuất ra các lệnh kiểm tra bản dựng (build-verify) và commit/push để người dùng tự chạy.

Không tự ý chạy bất kỳ lệnh build, commit hoặc push nào.