Conventies voor tijdelijke aanduidingen voor geheimen

Gebruik tijdelijke aanduidingen die menselijk leesbaar zijn, maar niet lijken op echte geheimen.

Aanbevolen stijl

Geef de voorkeur aan beschrijvende waarden zoals example-openai-key-not-real of example-discord-bot-token.
Geef voor shellfragmenten de voorkeur aan ${OPENAI_API_KEY} boven inline tekenreeksen die op tokens lijken.
Houd voorbeelden duidelijk nep en beperkt tot hun doel (provider, kanaal, auth-type).

Vermijd deze patronen in docs

Letterlijke header- of footertekst van een PEM-privésleutel.
Voorvoegsels die lijken op live-inloggegevens, bijvoorbeeld sk-..., xoxb-..., AKIA....
Bearer-tokens met een realistische uitstraling die uit runtimelogboeken zijn gekopieerd.

Voorbeeld

# 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