<html>
<body>
<blockquote type=cite class=cite cite=""><font size=3>A ~20 page spec
isn't a useful feature :)</blockquote><br>
Is the following at all useful? How can it be improved?<br><br>
.......................................................................<br>
<br>
0 Introduction<br><br>
Yadis uses URLs as identifiers. It provides a mechanism for
determining the services that are available with a given
identifier. <br><br>
6.1 Overview of the Yadis Protocol<br><br>
The purpose of the Yadis protocol is to enable a Relying Party to obtain
a Yadis Resource Descriptor that describes the services available using a
Yadis ID.<br><br>
6.1.1 Obtaining the Yadis Resource Descriptor<br><br>
When a User offers a Yadis ID to a Relying Party, that Relying Party will
want to discover which services are available using that Yadis ID.
<br><br>
Examples: Is it an OpenID URL, an XRI, a LID? <br>
What authentication methods are available? <br>
What other services?<br><br>
To do that, the Relying Party Agent makes an HTTP request. This
request may take any one of several forms, specified in Clause 6.2.3 of
the Yadis specification.<br><br>
In response to the request, the Relying Party Agent obtains either:<br>
1. A Yadis document.<br>
2. A URL that locates a Yadis document.<br><br>
If the Relying Party Agent obtains a URL, the Relying Party Agent uses
that URL to obtain the Yadis document.<br><br>
The Yadis document contains a Yadis Resource Descriptor, which identifies
the services available using that Yadis ID, including services that can
authenticate the User.<br><br>
7.1 Overview of the Yadis document<br><br>
The Yadis document is based on a simple, extensible XML document called
an Extensible Resource Descriptor (abbreviated 'XRD'). The format
of XRD documents is being specified by the XRI Technical Committee of
OASIS (see the XRI Resolution 2.0 specification .) The XML schemas
for the Yadis document are specified in Clause 7.5 of the Yadis
Specification. <br><br>
The Yadis document contains a Yadis Resource Descriptor, which provides a
list of identifiers of services. These are the services that know
the User identified by the Yadis ID used to obtain the Yadis
document. <br><br>
In the case of some services, additional data is included in the Yadis
Resource Descriptor for use by the Relying Party Agent in making a
request to that service. Such additional data is not specified in the
Yadis Specification but is specified in the definition of that
service.<br><br>
The Yadis Resource Descriptor also enables the User to specify which
services it prefers be used.<br><br>
</font></body>
</html>