W3C home > Mailing lists > Public > public-iri@w3.org > May 2010

Fwd: IESG Statement on the Usage of Assignable Codepoints, Addresses and Names in Specification Examples

From: Martin J. Dürst <duerst@it.aoyama.ac.jp>
Date: Tue, 25 May 2010 10:12:44 +0900
Message-ID: <4BFB240C.90908@it.aoyama.ac.jp>
To: "public-iri@w3.org" <public-iri@w3.org>
I'm forwarding this for two reasons. First, we'll of course have to make 
sure examples in our draft(s) conform to the guidelines below. From 
whatever was taken over from RFC 3987, my understanding is that this is 
already the case. (There are some explicit exceptions, but these are 
made for a reason, which means they are okay.)

I'm also forwarding this because when we update RFC 4395: "Guidelines 
and Registration Procedures for New URI Schemes", it may be a good idea 
to define an "example:" (or "ex:" or whatever) scheme. I think it would 
be good to open an issue for this in order not to forget it (->chairs).

Regards,    Martin.

-------- Original Message --------
Subject: IESG Statement on the Usage of Assignable Codepoints, 
Addresses 	and Names in Specification Examples
Date: Mon, 24 May 2010 10:58:26 -0700 (PDT)
From: IESG Secretary <iesg-secretary@ietf.org>
Reply-To: iesg@ietf.org
To: IETF Announcement list <ietf-announce@ietf.org>

Protocol specifications and other documents intended for RFC publication
often include useful examples with correctly formatted and syntactically
valid codepoints, addresses or names. Examples of codepoints, etc, are
such as email addresses, domain names, IP addresses or ports. Codepoint
values may already have been assigned or may become assigned in the
future to entities on the Internet.

The IETF has already reserved addresses, names and codepoints in a
number of spaces and domains: BCP 32 (RFC 2606 - Reserved Top Level DNS
Names) reserved some domain names for use in examples. RFC 5737 (IPv4
Address Blocks Reserved for Documentation) and RFC 5156 - Special-Use
Addresses) assigned some IP address ranges specially for examples and
documentation. RFC4735 (Example Media Types for Use in Documentation)
registered one example media type and one subtype under each of the
registered media types for example use. Other similar specifications and
reserved codepoints exist.

The IETF should minimize any potential impact on the entity having been
assigned such a codepoint from unwanted traffic or other concerns. To
help ensure this the IESG will expect the author of any Internet Draft
that defines a new specification to use values assigned for examples
whenever possible. The IESG also recommends new protocol specifications
creating new codepoint, address or names spaces to consider if some part
of the space should be reserved for documentation and example usage.
IETF-Announce mailing list
Received on Tuesday, 25 May 2010 01:13:32 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:39:41 UTC