updating read me

Author: Paul-doherty-aquaq

README.md

@@ -21,7 +21,7 @@ server.port=8080
 The kdb-rest-service provides two endpoints:executeFunction and executeQuery. 
 
 The executeFunction provides a means to call a predefined function and pass parameters to the kdb instance. 
-The format of the request:
+For example this is the format of a request call a function called plus which passes two arguments labelled "xarg" and "yarg" with values 96.3 and 9.7:
 
 e.g.
 {
@@ -33,9 +33,8 @@ e.g.
 }
 
 The executeQuery provides a means to provide a query to the kdb instance, by default this endpoint is disabled using the property freeform.query.mode.enabled, to enable change the value to true. 
-The format of the request:
+For example this is the format of a synchronous query request where the user expects a response to be returned:
 
-e.g.
 {
 "type" : "sync",
 "query" : "select from table",
@@ -56,11 +55,15 @@ server.ssl.key-store-password=aquaq2018
 server.ssl.key-alias=tomcat
 
 #####Authentication
-The rest service uses basic authentication and is using a single username and password which are configured in the applicationm.properties file and provided within the header of the request; again it is strongly recommeded to invoke your own security if you use the project.
+The rest service uses basic authentication and is using a single username and password which are configured in the application.properties file:
 
 basic.authentication.user=user
+
 basic.authentication.password=pass
 
+These value are provided within the header of the request, it is strongly recommended to invoke your own security if you use the project.
+
+
 ##Deploying 
 
 There is a DockerFile within the project for deploying the project on docker.