Thay gạch dưới trong tên snake_case bằng gạch nối: output_dir → output-dir. Tên chữ thường nối bằng gạch nối là chuẩn cho option dòng lệnh dạng dài, path URL, tên resource Kubernetes, tên package npm và class CSS, những nơi theo quy ước không dùng gạch dưới.
Trường hợp hay gặp là một script Python có option argparse hoặc key cấu hình viết bằng gạch dưới, nay cần dạng --flag-name theo quy ước, hoặc định danh trong database phải xuất hiện trong URL.
Chuỗi văn bản, mỗi dòng một mục hoặc viết liền đều được.Kết quả.--dry_run
--output_dir dist
--max_workers 4--dry-run
--output-dir dist
--max-workers 4Mỗi tên option nhận gạch nối, còn -- ở đầu và các giá trị dist và 4 được giữ. Trong argparse, --dry-run vẫn được đọc là args.dry_run, nên phía Python không thay đổi.
max_workers → max-workers, address_line_2 → address-line-2.--, / hay ?page=, được giữ nguyên._internal_id → internal-id.argparse và click chấp nhận --output_dir, nhưng người dùng mong đợi --output-dir. Chuyển danh sách option rồi cập nhật các lời gọi add_argument vẫn giữ nguyên tên thuộc tính (output_dir).
Mã danh mục như gift_cards hay order_history lưu trong bảng có thể thành path /gift-cards và /order-history, kiểu phổ biến hơn cho URL công khai.
__version__, không khớp và giữ nguyên gạch dưới.add_argument và từ khóa như store_true cũng bị chuyển, làm hỏng code. Chỉ dán phần tên.Không. kebab-case dành cho chuỗi như option, URL, tên file và tên resource; hãy giữ biến Python ở snake_case.
Tên trong Kubernetes cho phép chữ thường, chữ số và gạch nối, và đó chính xác là những gì trang này tạo ra từ đầu vào snake_case thông thường, kể cả đoạn chữ số.