Update platform definition

example/platform.yaml

@@ -1,24 +1,52 @@
+##### General Section #####
 general:
+    # List of timestamps where the simulator will break
+    # and call the callback function (cf breakpoints_callback entry)
     breakpoints: []
+    # Same as breakpoints but simulator will break every x second(s) 
     breakpoints_every: 0
+    # Define the callback to call when the simulator reach a breakpoint
     breakpoints_callback:
         file: "platform_test.py"
         callback: "callback"
+    # Turn on/off the debugging of esds
     debug: off
+    # Debug output file (default is ./esds.debug)
+    debug_file: "./esds.debug"
+    # Should esds take into account interferences
     interferences: on
 
+##### Nodes Section #####
 nodes:
+    # Number of nodes to simulate
     count: 5
+    # List of files used has implementation for each node
+    # Example: 
+    #  - 0,1,2 sender.py
+    #  - 3-4 receiver.py
+    # Note that @ will be replaced by the last node id ex:
+    # 0-@ receiver.py     is equivalent to     0-4 receiver.py
     implementations:
         - all sender.py
 
+##### Interfaces Section #####
 interfaces:
+    # Each entry for each node interfaces
     wlan0:
+        # Interface type (wired/wireless)
         type: "wireless"
+        # List of links between nodes in this interface
+        # Syntax infos:
+        # 1MBps = 1 megaBYTE per seconds
+        # 1Mbps = 1 megabit per seconds
+        # Each entry has the following format: <ListOfNodes> <Bandwidth> <Latency> <ListOfNodes>
         links:
-            - 0 1Bps 10s 0 
+            - 0 1Bps 10s 0
+        # List of transmission performance for each nodes (only for wireless interfaces)
+        # Each entry has the following format: <ListOfNodes> <Bandwidth> <Latency>
         txperfs:
             - 0-4 1Bps 10s
+    # Example of a wired interface
     eth0:
         type: "wired"
         links: