Konvensi placeholder rahasia

Gunakan placeholder yang mudah dibaca manusia tetapi tidak menyerupai rahasia sungguhan.

Gaya yang disarankan

Utamakan nilai deskriptif seperti example-openai-key-not-real atau example-discord-bot-token.
Untuk cuplikan shell, utamakan ${OPENAI_API_KEY} daripada string inline yang menyerupai token.
Pastikan contoh jelas palsu dan dibatasi sesuai tujuan (penyedia, saluran, jenis autentikasi).

Hindari pola ini dalam dokumentasi

Teks header atau footer kunci privat PEM literal.
Prefiks yang menyerupai kredensial aktif, misalnya sk-..., xoxb-..., AKIA....
Token bearer yang tampak realistis dan disalin dari log runtime.

Contoh

# 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}"

⌘I