- From: Etan Wexler <ewexler@stickdog.com>
- Date: Tue, 10 Aug 2004 03:11:58 -0700
- To: uri@w3.org
Consider the following as guidelines for dealing with the many undocumented or poorly documented URI schemes. * For documentation of unregistered or ill-defined schemes, use Informational-series ("FYI") Requests for Comments (RFC). Or use W3C group Notes. * Maintain a one-to-one correspondence between current documents and URI schemes. (The planned splitting of the scheme documentation in rfc1738bis is a Good Thing.) Resist the temptation to combine scheme documentation. Separate documents allow for better searching (a title like "The 'irc' URI scheme" is quite clear) and for stronger metadata (obsoleting rather than updating). * Maintain a usage document separate from all particular scheme documents. The usage document (again, an FYI or Note) would list the following data for each scheme, whether registered, unregistered, IETF-blessed, poorly documented, or whatever. * Name. * Level of use (say, "pervasive", "common", "rare"). * Expected change in level of use. * Reference to scheme-specific documentation. * Update the usage document regularly. What would be an appropriate interval? A year? Two years? -- Etan Wexler.
Received on Tuesday, 10 August 2004 10:14:16 UTC