Merge pull request #27 in LCL/wolframengineforpython from feature/docs to master

* commit '3b6321428d2dd79760479881db29965ec52c5848':
  adding a meaningful API
  fixing paragraph
  adding a note when installing using source code

Author: crazyeng

README.md

@@ -38,6 +38,8 @@ Install the library in your site-package directory:
 >>> pip3 install .
 ```
 
+The following method is not installing the library globally, therefore all the example commands needs to run from the cloned directory.
+
 ### Start a demo server
 
 Start a demo server by doing:
@@ -61,7 +63,7 @@ Now you can open your web browser at the address http://localhost:18000/
 1. Use a single file with URLDispatcher
 2. Use multiple files in a directory layout
 
-## Single file with URLDispatcher
+### Single file with URLDispatcher
 
 One way to run your server is to direct all requests to a single file
 that runs a Wolfram Language [URLDispatcher](https://reference.wolfram.com/language/ref/URLDispatcher.html) function.
@@ -98,7 +100,7 @@ http://localhost:18000/api
 
 For more information about `URLDispatcher` please refer to the [online documentation](https://reference.wolfram.com/language/ref/URLDispatcher.html).
 
-## Multiple files in a directory layout
+### Multiple files in a directory layout
 
 Another way to write an application is to create a directory structure that is served by the server. The url for each file will match the file's directory path.
 
@@ -116,8 +118,8 @@ mkdir testapp/form
 mkdir testapp/api
 echo 'ExportForm[{"hello", UnixTime[]}, "JSON"]' >  testapp/index.wl
 echo 'FormFunction["x" -> "String"]'             >  testapp/form/index.wl
-echo 'APIFunction["x" -> "String"]'              >  testapp/api/index.wl
-echo 'HTTPResponse["hello world"]'               >  testapp/api/response.wl
+echo 'APIFunction["x" -> "Number", #x! &]'       >  testapp/api/index.wl
+echo 'HTTPResponse["hello world"]'               >  testapp/response.wl
 echo '["some", "static", "JSON"]'                >  testapp/static.json
 ```
 
@@ -138,14 +140,15 @@ Then open the browser at the following locations:
 ```
 http://localhost:18000/
 http://localhost:18000/form
-http://localhost:18000/api
+http://localhost:18000/api?x=4
+http://localhost:18000/response.wl
 http://localhost:18000/static.json
 ```
 
 One advantage of a multi-file application structure is that is very easy to extend the application. You can simply place new files into the appropriate location in your application directory and they will automatically be served.
 
 
-### Options
+## Options
 
 ```
 >>> python3 -m wolframwebengine --help