add suggested changes

roles/jd-client/src/lib/mod.rs

@@ -371,11 +371,11 @@ impl JobDeclaratorClient {
         .await;
     }
 
-    /// Notifies the JD-Client to shut down gracefully.
+    /// Closes JDC role and any open connection associated with it.
     ///
-    /// This method triggers the shutdown process by sending a notification.
-    /// It ensures that any ongoing operations are properly handled before
-    /// the jd-client stops functioning.
+    /// Note that this method will result in a full exit of the  running
+    /// jd-client and any open connection most be re-initiated upon new
+    /// start.
     #[allow(dead_code)]
     pub fn shutdown(&self) {
         self.shutdown.notify_one();

roles/translator/src/lib/mod.rs

@@ -288,11 +288,11 @@ impl TranslatorSv2 {
             task_collector.safe_lock(|t| t.push((task.abort_handle(), "init task".to_string())));
     }
 
-    /// Notifies the translator to shut down gracefully.
+    /// Closes Translator role and any open connection associated with it.
     ///
-    /// This method triggers the shutdown process by sending a notification.
-    /// It ensures that any ongoing operations are properly handled before
-    /// the translator stops functioning.
+    /// Note that this method will result in a full exit of the  running
+    /// Translator and any open connection most be re-initiated upon new
+    /// start.
     pub fn shutdown(&self) {
         self.shutdown.notify_last();
     }