update docs

Signed-off-by: Tony Najjar <[email protected]>

Author: tonynajjar

include/behaviortree_cpp/bt_factory.h

@@ -118,9 +118,13 @@ class Tree
 
   [[nodiscard]] TreeNode* rootNode() const;
 
-  /// Sleep for a certain amount of time.
-  /// This sleep could be interrupted by the method
-  /// TreeNode::emitWakeUpSignal()
+  /**
+    * @brief Sleep for a certain amount of time. This sleep could be interrupted by the method TreeNode::emitWakeUpSignal()
+    *
+    * @param timeout  duration of the sleep
+    * @return         true if the timeout was NOT reached and the signal was received.
+    *
+    * */
   bool sleep(std::chrono::system_clock::duration timeout);
 
   ~Tree();