Missing Documentation

[fireproofsocks]

Seems like a promising library, but the documentation is missing. It's good to have an example of how to install composer, but missing here are examples of how to make even simple requests.

[matheo]

http://besim.pl/SoapBundle/soapclient/configuration.html ?

[fireproofsocks]

Best to put a link like that inside the main readme.md @ https://github.com/BeSimple/BeSimpleSoap where someone might actually find it.

That aside, that page is sort of a confusing mix of a reference and some examples, and in my opinion, it fails to accomplish either purpose. Some points:

1. What nodes are expected in the yaml? I can guess from the example, but it's only a guess. (i.e. complete the reference: what's the syntax? What options are available?)
2. What's the relationship between "be_simple_soap" in the yaml and "besimple.soap.client" in the client code? What other links are there betwen the yaml file and the code and are there any changes between the two (e.g. one version uses proper case, the other expects lowercase).
3. How are methods expected to be defined in the WebService class? E.g. $client->hello() calls what exactly? How is that defined in the WSDL?

I could go on, but I hope that helps explain why I filed this bug and what I think "normal" users (i.e. developers) might be expecting to see if this library is to be used. Since SOAP itself is poorly documented and its integrations are rarely clean (esp. PHP's implementation of it), it's critical to document full working examples.

[mablae]

+1

[delatbabel]

+1

Plus the documentation above does not document the base soap classes, it only documents the symfony bundle.