Sect 6.1 - remove 6.1.2 6.1.3
Section 6.1.1 states "The Yadis document contains a Yadis Resource Descriptor, which identifies the services available using that Yadis ID, including services that can authenticate the User"
I think sections 6.1.2 and 6.1.3 can be removed, all the information is contained in 6.1.1. The separate sections also risk misleading the reader by creating a divide between authentication services vs other services.
I have left this in.
As with the note at 6.2.10 (that's 6.2.9 in Version 0.9), I agree that it does not belong in the spec in the long term. But, until we have the Overview and Implementer's Guide, it is important to mention this. We don't want readers to be mystified, wondering what this is all about.
I appreciate the concern that the separate sections risk misleading the reader by creating a divide between authentication services vs other services. But this is, after all, in the first instance, about discovering authentication services. Of course, in the end it is about discovery of any and all services. My feeling is that this organization leads the reader through the same thought processes we went through.