From 0558ece2be7fe83d773684e073a6c5073f85984c Mon Sep 17 00:00:00 2001
From: ni-richard <ni-richard@protonmail.ch>
Date: Thu, 12 Sep 2019 16:01:10 +0200
Subject: [PATCH] Created process.start (markdown)

---
 process.start.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 process.start.md

diff --git a/process.start.md b/process.start.md
new file mode 100644
index 0000000..e472ff7
--- /dev/null
+++ b/process.start.md
@@ -0,0 +1,55 @@
+### Request
+* **Description**: Instructs the supervisor daemon to start a registered process.
+* **Subscribers**: [ProcessHandler](https://github.com/avatao-content/baseimage-tutorial-framework/wiki/ProcessHandler)
+
+```json
+{
+    "key": "process.start",
+    "intent": "control",
+    "scope": "zmq"
+}
+```
+
+| Parameter    | Type     | Required           | Description                 |
+| ------------ |:--------:|:------------------:| --------------------------- |
+| *name* | `string` | :heavy_check_mark: | Name of the process. |
+
+***
+
+**Example**:
+```json
+{
+    "key": "process.start",
+    "name": "webservice"
+}
+```
+
+### Response
+* **Description**: Raises an event that contains an `error` field if the process exited with an error code, otherwise it's just the same as the original request.
+* **Subscribers**: *(none)*
+
+```json
+{
+    "key": "process.start",
+    "intent": "event",
+    "scope": "broadcast"
+}
+```
+
+| Parameter    | Type     | Required           | Description                 |
+| ------------ |:--------:|:------------------:| --------------------------- |
+| *name* | `string` | :heavy_check_mark: | Name of the current FSM state. |
+| *error* | `string` | | Error message of the supervisor daemon. |
+
+***
+
+**Example**:
+```json
+{
+    "key": "process.start",
+    "intent": "event",
+    "scope": "broadcast",
+    "name": "webservice",
+    "error": "SPAWN_ERROR: webservice..."
+}
+```
\ No newline at end of file