​

Quy ước placeholder cho bí mật

​

Kiểu khuyến nghị

• Ưu tiên các giá trị mô tả như example-openai-key-not-real hoặc example-discord-bot-token.
• Với đoạn mã shell, ưu tiên ${OPENAI_API_KEY} thay vì chuỗi nội tuyến giống token.
• Giữ ví dụ rõ ràng là giả và giới hạn theo mục đích (nhà cung cấp, kênh, loại xác thực).

​

Tránh các mẫu này trong tài liệu

• Văn bản header hoặc footer khóa riêng tư PEM nguyên văn.
• Tiền tố giống thông tin xác thực đang hoạt động, ví dụ sk-..., xoxb-..., AKIA....
• Bearer token trông thực tế được sao chép từ nhật ký runtime.

​

Ví dụ

# Good
export OPENAI_API_KEY="example-openai-key-not-real"

# Better (when the doc is about env wiring)
export OPENAI_API_KEY="${OPENAI_API_KEY}"