more doc

README.md

@@ -14,4 +14,6 @@ BLUMYCELIUM allows you to write complex microservice orchestration all in python
 Readthedocs documentation
 =========================
 
-This part is a work in progress
+We provide a full documentation here (work in progress):
+
+[here](https://duckduckgo.com)

blumycelium/docs/quickstart.rst

@@ -40,12 +40,22 @@ Run the simple example below
     #NOTICE THAT TASK ARE FUNCTION WITH NAMES STARING WITH 'task_'
 
     class PrinterElf(melf.MachineElf):
-        """docstring for Printer"""
+        """
+        Notice the hint for the return. This is mandatory.
+        Type hints can also be used for arguments to ensure that tasks get
+        arguments of the right type.
+        """
         def task_print_it(self, to_print) -> None:
             print(">>> Machine >>> Elf >>> Printer: '%s'" % to_print)
 
     class SenderElf(melf.MachineElf):
-        """docstring for Printer"""
+        """
+        Notice the hint for the return. This is mandatory.
+        Type hints can also be used for arguments to ensure that tasks get
+        arguments of the right type.
+        Task must return either None or a dict. Here the return is a tuple of keys to a dictioray.
+        A list would also work, as well as a dict of types example: {"value": float}
+        """
         def task_send(self, to_send) -> ("value", ):
             return {
                 "value": to_send

demos/basic_demo.py

@@ -10,12 +10,22 @@
 #NOTICE THAT TASK ARE FUNCTION WITH NAMES STARING WITH 'task_'
 
 class PrinterElf(melf.MachineElf):
-    """docstring for Printer"""
+    """
+    Notice the hint for the return. This is mandatory.
+    Type hints can also be used for arguments to ensure that tasks get
+    arguments of the right type.
+    """
     def task_print_it(self, to_print) -> None:
         print(">>> Machine >>> Elf >>> Printer: '%s'" % to_print)
 
 class SenderElf(melf.MachineElf):
-    """docstring for Printer"""
+    """
+    Notice the hint for the return. This is mandatory.
+    Type hints can also be used for arguments to ensure that tasks get
+    arguments of the right type.
+    Task must return either None or a dict. Here the return is a tuple of keys to a dictioray.
+    A list would also work, as well as a dict of types example: {"value": float}
+    """
     def task_send(self, to_send) -> ("value", ):
         return {
             "value": to_send