Beefy Boxes and Bandwidth Generously Provided by pair Networks
The stupid question is the question not asked
 
PerlMonks  

SOAP::Lite

by Anonymous Monk
on Apr 15, 2006 at 04:18 UTC ( #543482=modulereview: print w/ replies, xml ) Need Help??

Item Description:

Review Synopsis:

Function proxy and uri are very poorly named. what does proxy mean? it can easily make people think that it is the server, should be called endpoint as it is perceived in the entire SOAP world. uri is hardly needed, but all examples in SOAP::Lite doc have that, you really cannot easily guess what should be passed in. When those two goes together, it becomes worse than anything.

It is easy to use after you stuggled pass the point, but that struggling really shouldn't be there with any well defined and documented computer program.

Considered by DrHyde: merge with 543674 if possible. titles are identical, anonymous authors probably identical
Unconsidered by Arunbear: node merging isn't supported; Keep: 5, Edit: 21, Reap: 7

Comment on SOAP::Lite
Re: SOAP::Lite
by PodMaster (Abbot) on Apr 15, 2006 at 09:09 UTC
    Function proxy and uri are very poorly named.
    proxy and uri are methods
    It can easily make people think that it is the server
    Not likely, but the documentation definitively clears up what the method does.
    , should be called endpoint as it is perceived in the entire SOAP world.
    Thats a good suggestion to make to the developers.
    uri is hardly needed, but all examples in SOAP::Lite doc have that
    The docs say otherwise: Nothing is specified by default and your call will definitely fail if you don't specify the required uri.
    you really cannot easily guess what should be passed in..
    Why would you guess when you can read the documentation which explains it?

    We've all been frustrated, but this kind of module review is not productive. You should talk to the developers.

    MJD says "you can't just make shit up and expect the computer to know what you mean, retardo!"
    I run a Win32 PPM repository for perl 5.6.x and 5.8.x -- I take requests (README).
    ** The third rule of perl club is a statement of fact: pod is sexy.

      "proxy and uri are methods"

      As well as functions, as SOAP::Lite can also be used non-OO style. So don't be too clever here.

      "The docs say otherwise: Nothing is specified by default and your call will definitely fail if you don't specify the required uri."

      Then the doc lied, since I can obviously use without specify uri, or the doc intentionally lie, but the author even didn't know how his module works. Before you open your mouth, try what I said first. get some hands-on experience, honey!

      "Why would you guess when you can read the documentation which explains it?"

      That's not the point, the point is that the fucntion names should be intuitive. Regardless.

      Considered: planetscape: Reap: troll
      Unconsidered: g0n - enough keep votes (Keep: 11, Edit: 1, Reap: 11)

Back to Reviews

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: modulereview [id://543482]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others pondering the Monastery: (5)
As of 2014-09-03 06:25 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    My favorite cookbook is:










    Results (35 votes), past polls