Additions.

docs/central-api/details.md

+## Central service
+
+The central service is available at [lambda.grnet.gr](https://lambda.grnet.gr/). It collects usage metrics from user owned λ services (i.e. number of deployed λ instances/applications) and contains documentation on deploying and using a λ service. 
+
 ## Central λ API
 
-The central λ API UML Class diagram is shown in the following picture. 
+The API listening of the central instance is responsible for collecting the usage metrics. This is not a user facing service. The central λ API UML Class diagram is shown in the following picture. 
 
 ![Screenshot](../images/central-api-uml.png)
 

docs/fokia/description.md

 
 
-## Usage
+## Installation
 
 Although, not intended to operate in this way, the Fokia library can be used to bootstrap and configure a λ instance. To install the Fokia library (locally) a user needs to have `pip` already installed and available.
 
@@ -28,6 +28,8 @@ Then install the Fokia library using the following command:
 $ sudo python setup.py install
 ```
 
+## Example
+
 To bootstrap a λ instance the `lambda_instance_manager.py` executable inside the `core/fokia/` folder can be used. The available options are shown in the listing below:
 
 ```sh
@@ -60,4 +62,8 @@ optional arguments:
                         Size of disk on Flink slave(s) (in GB) [default: 40GB]
 ```
 
+As an example with the command given below we bootstrap a λ instance comprised of one Flink master and 5 Flink slaves:
 
+```sh
+$ python lambda_instance_manager.py --slaves 5
+```

mkdocs.yml

@@ -43,4 +43,4 @@ pages:
 - 'License': 'about/license.md'
 
 
-theme: mkdocs
+theme: readthedocs