I have a lot of sympathy for Rasmus' comment about the Yahoo search service, where he says
"But don't even try to read the SOAP spec. If you managed to fight your way through that spec already, try the new WSDL 2.0 Draft Spec. This is the sort of stuff that makes my brain hurt"
As one of the advocates that spec readability and spec completeness are not orthogonal, I am disappointed in WSDL 2.0's lack of readability. I continue to believe that specs have to be "marketed" to communities and part of that is making them readable/usable without the need for primers.
But he should take a look at what he can do with WSDL 2.0. Interestingly, I specifically used WSDL 2.0 to describe Yahoo's REST api. I think it's darn slick.