ZF-6346: The WSDL documentation element must be the first child of the documented node


In Zend_Soap_Wsdl, the {{addDocumentation()}} method appends the {{documentation}} element to the documented node. This is invalid with regard to the WSDL XML Schema as well as the WS-I Basic Profile 1.1, and can cause validation errors. The {{documentation}} element must be the first child of the node.


This patch fixes the issue mentioned above, and updates the method's docblock to explain why the 'documentation' element is used instead of 'document'. Basically, the WSDL spec is wrong, the WSDL schema is right and confirmed by the WS-I Basic Profile 1.1.

I had to made some changes to your patch since it did not lead to the correct result in all cases.

Committed to trunk and 1.8 release branch.