воскресенье, 10 мая 2009 г.

Аккуратнее с этими URL для примеров

Это перевод Watch out for those sample URLs. Автор: Реймонд Чен.

Когда мы пишем документацию, нам иногда нужно вставить URL-пример, чтобы продемонстрировать что-то. Когда вы это делаете, убедитесь, что URL для примера находится под вашим контролем.

Я помню Windows beta, которая использовала в качестве примера URL http://www.xxxxx.com/ в диалоговом окне. Вы можете угадать, что там находится сейчас.

Этот web-сайт использует в качестве примера URL www.wallyworld.com (прим. пер.: обе ссылки сейчас не работают). Возможно они не осознавали, что это сайт с гей-порно.

(Странная история сна Реймонда: однажда мне приснился сон, что я нашёл сайт с полным архивом работ Дилберта, и по какой-то причине он назывался "Wally World". Утром я попробовал найти такой сайт и получил такой сюрприз...)

Так что лучше перестрахуйтесь. Когда вам нужен URL для примера, не надо брать что-то от балды. Если вы так сделаете, есть хорошие шансы, что кто-то возьмёт и зарегистрирует сайт с таким именем. Убедитесь, что ваши URL или указывают на ваш сайт или используйте http://www.example.com, который IANA зарезервировала для использования в качестве демонстраций. Если это кажется вам дурацким, то просто возьмите и зарегистрируйте себе доменное имя, которое вы сможете использовать как пример, и никто больше не сможет использовать его (правда, при этом у вас будет проблема постоянной его оплаты).

2 комментария:

  1. Анонимный14 мая 2009 г., 22:25

    xxxxx.com работает

    ОтветитьУдалить
  2. Надо брать пример с Голливуда - и телефонные номера у них вымышленные (555-...), и доменные имена заранее куплены: http://dunkin-my-tits-hynes.com/

    ОтветитьУдалить

Можно использовать некоторые HTML-теги, например:

<b>Жирный</b>
<i>Курсив</i>
<a href="http://www.example.com/">Ссылка</a>

Вам необязательно регистрироваться для комментирования - для этого просто выберите из списка "Анонимный" (для анонимного комментария) или "Имя/URL" (для указания вашего имени и ссылки на сайт). Все прочие варианты потребуют от вас входа в вашу учётку (поддерживается OpenID).

Пожалуйста, по возможности используйте "Имя/URL" вместо "Анонимный". URL можно просто не указывать.

Ваше сообщение может быть помечено как спам спам-фильтром - не волнуйтесь, оно появится после проверки администратором.