Re: VOSpace WSDL

On 13.06.2006, at 18:42, Matthew Graham wrote:

> Paul Harrison wrote:
>
>> I have posted VOSpace WSDL 1.0 release candidate 1 to the wiki
>> http:// www.ivoa.net/twiki/bin/view/IVOA/VOSpace10schema
>> for discussion - please do!
>>
>> Paul Harrison
>> ESO
>>
> Hi,
>
> I notice that your new name suggestions are not in the WSDL - is
> this intentional?

It was, as we had not discussed the issue...

> I also have to say that I find that I have to think slightly longer
> with your name suggestions about who is doing what than the current
> names so I would rather stick with the current ones (which also do
> not make a distinction between client/server).

not sure I understand this comment, my new suggestions are clear about which is the active party in the transfer and the current names are not.

In making this suggestion I am trying to put myself in the position of a newcomer client software writer (who will only have skimmed the documentation before attempting to write his software) His goal is to write code to put some data into VOSpace, so he will look at the list of operations to see which is suitable. With the current names he has to

1. scan down to find "to" or "from" in the middle of the operation name to select which pair is relevant
2. then work out the difference between push and pull - intuitively they might think that they know how they can "push" data as a client, but they are going to wonder how they can "pull to" - they will read the documentation better and realise that is it is the server that does the pulling...

with my suggestions I think that this process is easier because it is

1. much easier to see the verb that describes the overall goal
2. explicit about whether it is client or server that is active.

>
> Cheers,
>
> Matthew
Received on 2006-06-14Z09:54:56