[OpenID] New XRI/i-names wiki (was RE: why is xri so obtuse?)

Drummond Reed drummond.reed at cordance.net
Tue Jan 2 02:13:41 UTC 2007

Martin, I can't believe it! I feel like the Michigan team that got pasted by
USC in the Rose Bowl today: you're one step ahead of every message I'm
writing today!!

So here it is: on behalf of all of us working on XRI specifications,
registries, resolver code, server cord, and other XRI infrastructure...

********   W E    H  E  A  R     Y  O  U  !!!!!!!!!!!!!   ********

Phil Windley, Doc Searls, and a number of other folks told us the same thing
at the Internet Identity Workshop Dec. 4-6. So the XRI community discussed
it and quickly came to the conclusion we should do exactly what the OpenID
community is doing: create a single consolidated wiki devoted to everything
developers need to know to understand and use XRI i-name/i-number

Les Chasen of NeuStar (http://xri.net/=les.chasen/(+contact) ) undertook to
set this up over the holidays (thank you Les!), and thanks to help he got
from the good folks at JanRain (see below), it's fully i-names and
OpenID-enabled. The address is:


(Note that dev.inames.net formerly pointed at a site that Eugene Kim helped
create on XRI and i-names for developers, but it wasn't an
i-name/OpenID-enabled wiki. This new one is a full i-name/OpenID-Mediawiki
hosted by NeuStar on behalf of XDI.org, so it should be rock-solid, and over
the next week we'll be migrating any content we need from the old wiki to
the new one.)

The big caveat: it's brand new, so only a handful of the pages proposed on
the current front page exist so far. One of the most useful might be the
page Les created on the process he went through to bring up a fully
i-name/OpenID-enabled wiki with help from the JanRain team:


What I promise to do over the coming week is cajol the XRI/i-names community
to start adding content to the wiki as fast as we possibly can to address
all the great questions you have posed. I certainly invite all members of
the OpenID community to do the same, even if it's just to post the FAQ
questions you most want to see answered or code/documentation you want to
see written.

Thanks and Happy New Year,


-----Original Message-----
From: general-bounces at openid.net [mailto:general-bounces at openid.net] On
Behalf Of Martin Atkins
Sent: Monday, January 01, 2007 5:18 PM
To: general at openid.net
Subject: Re: [OpenID] why is xri so obtuse?

Greg Hewgill wrote:
> Now, in order to try to catch up with all the latest developments, I've
> tried to read about XRI and i-names and now I'm completely baffled.

When I raised a similar concern about XRI, I was asked to be a bit more 
specific about what was bothering me. Since then, I have been making an 
effort to try to figure all of this stuff out, and these are the main 
obstacles I have hit:

  * The information about all this stuff is spread all over the shop and 
it's near-impossible to find answers to specific questions.

  * The specs all suffer from "out-of-scope-itis": that is, every 
document is an incomplete picture and references a bunch of other 
documents, each of which themselves reference still more documents. 
There doesn't seem to be anywhere to get the "big picture" or a 
description of how this architecture operates in the common cases.

  * As a specific instance of the above, I've been unable to find 
anywhere that tells me how to resolve XRIs under the GCS roots. (For the 
uninitiated, these are XRIs that start with =, @, +, $ or !). The 
closest I've come is the XRI 2.0 FAQ[1], which states:

     Resolution of an XRI rooted by a GCS character requires
     pre-configuration of a resolver (or its proxy) with the location
     of the GCS root. This is out of scope for the XRI specification

   I understand the need to compartmentalize the specs, but it seems 
ridiculous that this particular information is so hard to find given 
that you absolutely can't resolve most XRIs without it!

  * The existing implementations out there seem to be largely out of 
date, as far as I can tell. The Perl module "XRI" on CPAN doesn't work 
because (I assume) it has outdated configuration for the GCS roots. I 
guess the Java OpenXRI implementation is up-to-date, but as is typical 
of Java libraries there appears to be no simple example or "common case" 
easy API, so you already have to understand nearly everything about XRI 
before you can begin to grok the library.

   Ideally I'd just like a simple tool like the xriresolve.pl that comes 
with the CPAN XRI package which does resolution of an arbitrary XRI 
while printing out verbose progress information so that I can understand 
what it's doing. If someone would point me to an up-to-date one of these 
I'd be very grateful.


My main suggestion to the XRI folks would be to put up some introductory 
documents explaining the technical aspects of XRI and some complete 
examples of transactions for common tasks like resolving an XRI to an 
XRDS (both with and without a proxy resolver) or interacting with the 
forwarding service. If you've already got such documents, please both 
point me at them and publish links to them in a more obvious place!

[1] http://www.oasis-open.org/committees/xri/faq.php#_Toc121168695
general mailing list
general at openid.net

More information about the general mailing list