TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: URLs to use in examples From:Mike Stockman <stockman -at- jagunet -dot- com> To:"Jennifer Delmerico" <jennifer -dot- delmerico -at- brokatfs -dot- com>, "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 17 Dec 1999 17:06:56 -0500
On 12/17/99 1:48 PM, Jennifer Delmerico (jennifer -dot- delmerico -at- brokatfs -dot- com)
wrote:
>I want to use a URL as an example in my manual. I know I've seen
>discussion here about some "standard" non-URLs that can be used as
>examples without running the risk of using a real URL. Or did this just
>apply to IP addresses?
We had this discussion not too long ago, and I offered the following
advice:
>Just for reference, there *is* an existing standard for using example
>domain names, in documentation or anywhere else. RFC2606 (found at
><http://www.faqs.org/rfcs/rfc2606.html> among other places) says this:
>
>>Abstract
>>
>> To reduce the likelihood of conflict and confusion, a few top level
>> domain names are reserved for use in private testing, as examples in
>> documentation, and the like. In addition, a few second level domain
>> names reserved for use as examples are documented.
>
>[snip]
>
>>3. Reserved Example Second Level Domain Names
>>
>> The Internet Assigned Numbers Authority (IANA) also currently has the
>> following second level domain names reserved which can be used as
>> examples.
>>
>> example.com
>> example.net
>> example.org
>
>Given that these are reserved, they can (and probably should) be used
>anywhere you want to provide a domain name example without worrying about
>where it will take the user. Presumably, variations on these domains are
>safe as well, such as prepending "www" or "ftp" onto any of them.