Index: README.txt
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/soap_server/README.txt,v
retrieving revision 1.2.2.1.2.1.2.2
diff -u -r1.2.2.1.2.1.2.2 README.txt
--- README.txt	17 Jan 2011 18:10:40 -0000	1.2.2.1.2.1.2.2
+++ README.txt	22 Jan 2011 00:19:38 -0000
@@ -1,31 +1,49 @@
-$id$
+// $Id$
 
-SOAP Server
-===========
-
-Soap Server for Services 6.x-3.x
-
-WARNING:  This module is a prototype and is not secure.  DO NOT USE FOR PRODUCTION SITES
-
-GETTING STARTED
-===============
-
-Enable the module
-Add an endpoint at admin/build/services/add choosing SOAP as the Server
-Enable the node and user retrieve methods at admin/build/services/{endpoint_name}/resources
-View the generated WSDL at soap_server/debug_wsdl/{endpoint_name}
-Give anonymous user 'access soap server' permission  - NOT FOR PRODUCTION USE
-Use SOAPUI or ther test client to import the WSDL from http://example.com/{endpoint_path}?wsdl
-or
-Enable devel module
-View a node object and user object debug client at soap_server/debug_client/{endpoint_name}/{nid}
-The debug client will show:
-ARGS
-Endpoint object
-Node object
-
-Available client functions
-The XML of the request
-The XML of the response
-The node object retrieved from the node.retrieve service from the supplied nid
-The user object for user 1
+Summary
+-------
+Provides a SOAP server implementation to be used as service handler for services
+module. This module version only works with Service 6.x-3.x versions. If you are
+using a different version of Services module, download the same version of the
+SOAP server implementation.
+
+Requeriments and recomendations
+-------------------------------
+This module requires Services module.
+
+The debug functionality provided by the module only works if Devel module is
+enabled. When displaying debug information, the results will include content in
+XML format. To enhance the visualization of this information, the syntax of this
+information will be highlighted if you have enabled the Gheishi module.
+
+Installation
+------------
+Copy module folder to your modules directory and then enable it. Make sure you
+have downloaded the same Services module version. Go to Services configuration
+section and SOAP will be available as server in the Endpoint settings page.
+
+Configuration
+-------------
+The SOAP server method has no additional configuration settings.
+
+Getting started
+---------------
+The following instructions will guide to create a Services endpoint using SOAP:
+- Once the module is enabled, go to 'Add Endpoint' at admin/build/services/add.
+- Select the 'SOAP' Server option, and enable 'Connect' in 'System resources' at
+  admin/build/services/{endpoint_name}/resources.
+- Manually review the generated WSDL at soap_server/debug_wsdl/{endpoint_name}
+  and verify that 'Connect' is listed as message in the generated XML.
+
+Using the browser to verify the Endpoint:
+- go to soap_server/debug_endpoint/{endpoint_name}/Connect and verify that
+  the webserver returns a session Id and your current user object.
+
+Using an external client:
+- Give anonymous user 'access soap server' permission at admin/user/permissions.
+- Use SOAPUI or any test client to import the generated WSDL definition from:
+  http://host/{endpoint_path}?wsdl  <- add the ?wsdl parameter to the endpoint.
+  verify that 'Connect' method is available at the service.
+- Request the method using a test client and verify that you get a session id
+  and a user object (the results may be different if you provide a valid http
+  session to the server).