Doc.

src/ws_deque.mli

@@ -104,10 +104,11 @@ val steal_drop_exn : 'a t -> unit
 *)
 
 (** {2 Multicore example} 
-**Note** that the use of a barrier is only necessary to make the result of 
-  this example interesting by improving the likelihood of parallelism. 
-  Spawning a domain is a costly operation compared to the work actually run on them
-  here. In practice, you should not use a barrier.
+  Note: The barrier is used in this example solely to make the results more
+  interesting by increasing the likelihood of parallelism. Spawning a domain is 
+  a costly operation, especially compared to the relatively small amount of work
+  being performed here. In practice, using a barrier in this manner is unnecessary.
+
 
 {@ocaml non-deterministic=command[
       # open Saturn.Work_stealing_deque