docs: ClientBootstrap reuse is not important but permissible on the same thread/EL

Sources/NIOPosix/Bootstrap.swift

@@ -778,8 +778,17 @@ extension Channel {
 
 /// A `ClientBootstrap` is an easy way to bootstrap a `SocketChannel` when creating network clients.
 ///
-/// Usually you re-use a `ClientBootstrap` once you set it up and called `connect` multiple times on it.
-/// This way you ensure that the same `EventLoop`s will be shared across all your connections.
+/// You may re-use a `ClientBootstrap` once you set it up and call `connect` multiple times on it.
+/// This ensures all connections you create share the same `EventLoop`.
+///
+/// Keep in mind that `ClientBoostrap` is not `Sendable`, so you cannot share the same
+/// instance across multiple `EventLoop`s or multiple concurrency domains in general. 
+/// Creating a `ClientBootstrap` is cheap. So instead of arranging synchronization allowing
+/// concurrent code to re-use a single `ClientBootstrap` instance across many tasks, it is often 
+/// easier to create a dedicated instance for each task.
+/// multiple threads/`EventLoop`s. Creating a `ClientBootstrap` is cheap so instead of arranging
+/// synchronization to re-use a single `ClientBootstrap` instance across threads, it's advisable to
+/// create fresh instances.
 ///
 /// Example:
 ///
@@ -797,7 +806,7 @@ extension Channel {
 ///             // resolves to both IPv4 and IPv6 addresses, cf. Happy Eyeballs).
 ///             channel.pipeline.addHandler(MyChannelHandler())
 ///         }
-///     try! bootstrap.connect(host: "example.org", port: 12345).wait()
+///     try bootstrap.connect(host: "example.org", port: 12345).wait()
 ///     /* the Channel is now connected */
 /// ```
 ///