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 phpsoa@googlegroups.com
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to