Gereserveerde domeinnamen: waarom example.com meer zegt dan je denkt

Als je technische documentatie schrijft, tutorials maakt of DNS uitlegt aan je team, wil je domeinnamen die niet per ongeluk naar echte servers wijzen. Daarvoor bestaan gereserveerde domeinnamen. Ze spelen een grotere rol dan veel developers denken.

Wat zijn gereserveerde domeinnamen?

ICANN heeft bewust een aantal domeinnamen apart gehouden voor documentatie en onderwijs. De bekendste zijn:

• example.com
• example.org
• example.net

Daarnaast bestaan er ook domeinen zoals example.edu, test.com en localhost.com. Deze zijn geen vergissingen of ongebruikte registraties. Het zijn bewuste keuzes om te voorkomen dat voorbeelden per ongeluk in productie terechtkomen.

Waarom dit belangrijk is

Stel dat je een blogpost schrijft over SSL-certificaten. Het is verleidelijk om je eigen domein als voorbeeld te gebruiken. Maar wat als iemand je code letterlijk kopieert naar een live-omgeving? Of erger: wat als je voorbeeld-domein tussen het schrijven en publiceren van je post nog geregistreerd wordt?

Gereserveerde domeinnamen nemen die risico's weg. Ze wijzen nooit naar een echte server, waardoor ze veilig zijn voor:

• Technische documentatie
• Codevoorbeelden in GitHub-repos
• Tutorialvideo's
• API-documentatie
• Configuratietemplates
• Demonstraties in whitepapers

Hoe professionals ermee omgaan

Bij NameOcean zien we dat de beste technische schrijvers gereserveerde domeinnamen net zo serieus nemen als versiebeheer. Ze behandelen het als een vaste gewoonte.

Als you een DNS-configuratie of SSL-installatie beschrijft, zorgt example.com ervoor dat je publiek meteen begrijpt dat dit educatief materiaal is. Zo scheid je "leren" van "produceren".

Hoe gereserveerde domeinnamen passen bij modern ontwikkelen

Deze domeinnamen werken goed met:

Docker en containers – In Dockerfile-voorbeelden kun je example.com veilig gebruiken zonder dat CI/CD-pipelines onverwachte netwerkoproepen krijgen.

Mocking en testing – Mock-servers kunnen example.org als domein gebruiken zonder te botsen met je echte infrastructuur.

Infrastructure-as-Code – Terraform, CloudFormation en Ansible-playbooks worden duidelijker als configuratievoorbeelden met gereserveerde domeinnamen geschreven zijn.

AI-gedreven ontwikkeling – Als je met NameOcean's Vibe Hosting werkt en AI helpt bij codegeneratie, zorgt gebruik van gereserveerde domeinnamen ervoor dat de AI context begrijpt. Zo genereert het code die portabel en zonder risico van real-world references blijft.

Hoe DNS werkt met example.com

De meeste developers vergeten dat DNS bij example.com gewoon correct werkt. Deze domeinnamen hebben specifieke A- en AAAA-records die naar documentatieservers van de IANA wijzen. Je krijgt dus een antwoord, maar dat verwijst niet naar een productie-server.

Probeer maar eens:

dig example.com
nslookup example.org

Je ziet echte DNS-reacties,而不是 NXDOMAIN-fouten. Dit is opzettelijk.

Wat je beter niet doet

Gebruik ze niet in productie – Ook al kunnen ze worden opgelost, ze zijn bedoeld voor documentatie. Je monitoring zal je dankbaar zijn als je je echte domeinen voor live traffic houdt.

Vertrouw er niet op als permanent – Hoewel de kans klein is, zijn gereserveerde domeinnamen voor mission-critical toepassingen niet ideaal.

Mix ze niet met real-world domeinen – Kies één type voor je voorbeelden. Zo vermijd je dat je publiek twijfelt wat is learned en wat is live.

De toekomst met AI

Als AI-assist tools steeds geavanceerder worden, zijn duidelijke grenzen tussen documentatie en productie belangrijk. Gereserveerde domeinnamen helpen AI-systemen te begrijpen wat bedoeld is voor direct gebruik en wat aangepast moet be worden.

Gereserveerde domeinnamen zijn een kleine stap naar professionele documentatie. Ze maken het verschil tussen tutorials die developers vertrouwen en tutorials die ze nerveus maken.

Als you je volgende technische documentatie schrijft, kies dan gewoon voor example.com. Je toekomstige zelf en iedereen die je docs leest, zullen het waarderen.