Fix docstrings

Author: esteve

rclrs/src/node/client.rs

@@ -198,13 +198,14 @@ where
         Ok(rx.await.unwrap())
     }
 
-    // Fetches a new response.
-    //
-    // When there is no new message, this will return a
-    // [`ClientTakeFailed`][1].
-    //
-    // [1]: crate::RclrsError
+    /// Fetches a new response.
+    ///
+    /// When there is no new message, this will return a
+    /// [`ClientTakeFailed`][1].
+    ///
+    /// [1]: crate::RclrsError
     //
+    // ```text
     // +----------------------+
     // | rclrs::take_response |
     // +----------+-----------+
@@ -218,6 +219,7 @@ where
     // +----------v----------+
     // |      rmw_take       |
     // +---------------------+
+    // ```
     pub fn take_response(&self) -> Result<(T::Response, rmw_request_id_t), RclrsError> {
         let mut request_id_out = rmw_request_id_t {
             writer_guid: [0; 16],

rclrs/src/node/service.rs

@@ -110,13 +110,14 @@ where
         })
     }
 
-    // Fetches a new request.
-    //
-    // When there is no new message, this will return a
-    // [`ServiceTakeFailed`][1].
-    //
-    // [1]: crate::RclrsError
+    /// Fetches a new request.
+    ///
+    /// When there is no new message, this will return a
+    /// [`ServiceTakeFailed`][1].
+    ///
+    /// [1]: crate::RclrsError
     //
+    // ```text
     // +---------------------+
     // | rclrs::take_request |
     // +----------+----------+
@@ -130,6 +131,7 @@ where
     // +----------v----------+
     // |      rmw_take       |
     // +---------------------+
+    // ```
     pub fn take_request(&self) -> Result<(T::Request, rmw_request_id_t), RclrsError> {
         let mut request_id_out = rmw_request_id_t {
             writer_guid: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],