Ryan Hoegg wrote:
sean wrote:I was thinking of using the Apache XML-RPC project as an application framework for some projects I have coming up. The site at http://xml.apache.org/xmlrpc/ seemed somewhat filled out, but there's a terrible lack of "how-to" documentation there and I couldn't find much news or other signs of activity.
What kind of how-to documentation are you looking for? We are aware that the documentation is scanty, but as a potential user your ideas of what a "Getting started" document would contain would be very helpful.
The "Client Classes" link (http://xml.apache.org/xmlrpc/client.html) on the web page gives some information on using the XML-RPC client classes, and the "Server Side XML-RPC" link (http://xml.apache.org/xmlrpc/server.html) gives some information on using the library to provide an XML-RPC interface to your software.
What would be nice is if you did away with the server example that's there now entirely and put up a "Hello, world" application (complete source, nothing fancy) with full instructions on getting the example working so anyone new who comes along can follow the instructions, get the server working, then contact the server with a browser (like Netscape) and see the results.
The snippets that are there now are tedious to assemble into a working server. The example isn't complete in terms of "here's you get you an XML-RPC server going" so I'm left with no way to figure out how to fill in the blanks except by poking around, guessing...testing. It's very stressful on this newcomer.
Once I see a "Hello, world" example application running, then I will know I have all the necessary components installed, and I can then extend the example to start handling the tasks I need the application to perform.
Sean O'Dell
