Hi Graham Comments in line...
On 22 Mar, 13:05, "[EMAIL PROTECTED]" <[EMAIL PROTECTED]> wrote: > Hi All, > > During the creating of some samples for PHP Quebec, I noticed a few > minor niggles I think we could improve.: > > 1. @binding.ws - 'ws' is not particularly meaningful. I think we're > unlikely to support anything other than soap with this binding, so +1 I would say the justification is simply that ws is soap for us and if we want other forms of ws we will call them something else > think @binding.soap would be much better. > 2. @binding.rest.rpc - we have @binding.jsonrpc and @binding.xmlrpc. > I think we should change this one to @binding.restrpc for consistency. +1 it makes the directory structure more sensible also > 3. Complex types declarations - we currently require developers to > specify @param <type_name> <namespaceURI> <Description> . This is a > bit of an abuse of phpDocumentor and slighly breaks the documentation > generation. It is also a little difficult to read (I always expect > them to be the other way round, but the type name is first for > phpDocumentor.). I would like to propose we change this to @param > <namespaceURI>#<type_name> <Description>. > +1 works for me but how did you choose #? Is this from some namespace convention somewhere or is it a PHP thing? > I wanted to discuss these here because if we make the changes, then > people's code will break. Thoughts? > > Regards, Graham. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "phpsoa" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en -~----------~----~----~----~------~----~------~--~---
