Зачем в примерах используют example.com

Если вы пишете документацию, создаёте примеры кода или готовите обучающие материалы, вы наверняка уже сталкивались с доменом example.com. Но почему именно он, а не любой другой?

Почему нельзя использовать реальные домены

Представьте, что вы пишете инструкцию по настройке DNS для своего хостинга. Решаете использовать в примерах свой рабочий домен — company.com или my-startup.io.

Через несколько месяцев кто-то находит вашу статью в поиске, копирует настройки один в один и отправляет трафик на ваш домен. Ещё хуже, если человек ошибётся с настройкой почты и начнёт получать чужие письма.

Именно для таких случаев и существуют резервные домены.

Что такое резервные домены IANA

Организация IANA выделила специальные домены, которые никогда не зарегистрируют и которые не ведут на реальные серверы. Их можно безопасно использовать в документации, тестах и примерах.

Самые известные из них:

• example.com — основной домен для документации
• example.org — для некоммерческих примеров
• example.net — ещё один вариант от IANA
• test.com — для тестирования
• localhost — для локальной разработки

Почему это важно для разработчиков

Когда вы пишете документацию для облачного хостинга или создаёте обучающий контент, использование reserved domains даёт несколько преимуществ.

Безопасность и ясность
Пример с example.com сразу показывает читателю, что перед ним не рабочая конфигурация. Это снижает риск ошибок.

Отсутствие побочных эффектов
Резервные домены не создают реальных DNS-запросов, поэтому не нагружают инфраструктуру и не вызуют лишних алертов у команды DevOps.

Признаваемость в сообществе
Все разработчики сразу понимают, что example.com — это пример, а не реальный endpoint. Не нужно объяснять дополнительно.

Защита от юридических проблем
Использование reserved domains помогает избежать конфликтов с владельцами реальных доменов и не отправляет трафик на чужие ресурсы.

Где это применяется

Документация API