Index: trunk/docs/services/howtos.rst
===================================================================
--- trunk/docs/services/howtos.rst	(revision 941)
+++ trunk/docs/services/howtos.rst	(revision 967)
@@ -27,4 +27,29 @@
 
 You'll find here information needed to deploy your own Python Services Provider.
+
+ZOO-API
+*******
+
+From your python module where you define your services, you can access
+the ZOO-API by importing the ``zoo`` module. No need to install
+anything here, the module will be automatically created from the
+ZOO-Kernel code at runtime.
+
+The following attributes are available from the ZOO-API :
+
+SERVICE_SUCCEEDED
+    Value to return in case your service end successfully.
+SERVICE_FAILED
+    Value to retrun in case of failure.
+    
+
+The following functions are defined in the ZOO-API:
+
+_(strToTranslate)
+    return the translated string (using the "zoo-service" `textdomain
+    <http://www.gnu.org/software/libc/manual/html_node/Locating-gettext-catalog.html#index-textdomain>`__)
+
+update_status(dictConf,iPourcent)
+    update the status of the running service
 
 Python ZCFG requirements
@@ -102,5 +127,5 @@
   {
   'variable_name': {'minOccurs': '1',
-		    'DataType': 'string',
+		    'dataType': 'string',
 		    'value': 'this_is_the_value',
 		    'maxOccurs': '1',
@@ -118,5 +143,5 @@
 
   {
-  'result': {'DataType': 'string',
+  'result': {'dataType': 'string',
 	     'inRequest': 'true',
 	    }
@@ -157,5 +182,5 @@
 
 The ZOO-API for the PHP language is automatically available from your
-service code. Tthe following functions are defined in the ZOO-API:
+service code. The following functions are defined in the ZOO-API:
 
 int zoo_SERVICE_SUCCEEDED()