-* `kong_servers`: an array of kong\_server to configure with followin configuration:
- * `kong_app_admin_url` the kong admin url (mandatory).
- * `kong_app_admin_apikey` the apikey to use kong admin api. Default to ""
- * `services` an array of services to setup (default to [])
- * `name` the name of the service to create for this app, mandatory
- * `url` the url of the backend of the app, mandatory
- * `plugins` An array of plugins to activate with their name and config in a dict
+* `kong_servers`: an array of kong_server to configure with the following configuration:
+ * `kong_app_admin_url` the kong admin API url (mandatory).
+ * `kong_app_admin_apikey` the apikey to use during kong admin api calls. Defaults to `""`
+ * `services` an array of services to setup. Defaults to `[]`.
+ * `name` the name of the service to create for this app, **mandatory**
+ * `url` the url of the backend of the app, **mandatory**. May refer to an upstream by its name (https://upstream_name/path)
+ * `upstream` if the url reference an upstream a dict with the configuration, optional
+ * `conf` the configuration as expected by kong for an upstream creation
+ * `name` mandatory name for the upstream
+ * `healthchecks` optional healthchecks configuration as expected by kong api
+ * `targets` an array of dict defining a target for kong
+ * `target` the host:port to reach the target, **mandatory** if a target is defined
+ * `weight` the weight of the target, optional
+ * `plugins` An array of plugins to activate with their name and config in a dict. (Plugin objects are defined in the [Kong API documentation](https://docs.konghq.com/2.1.x/admin-api/#plugin-object))