docs: add docs to the new connect/disconnect/alias features

Author: amab8901

testcontainers/src/core/containers/async_container.rs

@@ -71,15 +71,16 @@ where
         Ok(container)
     }
 
-    pub async fn connect(&mut self, net: Option<Arc<Network>>) -> Result<()> {
+    /// Connect the container to `network`.
+    pub async fn connect(&mut self, network: Option<Arc<Network>>) -> Result<()> {
         let container_id = self.id().into();
-        let net = if let Some(net) = net {
-            net
+        let network = if let Some(network) = network {
+            network
         } else {
             return Ok(());
         };
 
-        let net_aliases_vec = net.aliases.clone().into_iter().collect();
+        let net_aliases_vec = network.aliases.clone().into_iter().collect();
         let endpoint_settings = EndpointSettings {
             aliases: Some(net_aliases_vec),
             ..Default::default()
@@ -91,13 +92,14 @@ where
         };
         self.docker_client
             .bollard
-            .connect_network(&net.name, bollard_netword_connect_request)
+            .connect_network(&network.name, bollard_netword_connect_request)
             .await
             .map_err(|err| TestcontainersError::Client(ClientError::ConnectionError(err)))?;
 
         Ok(())
     }
 
+    /// Disconnect the container from the network `name`.
     pub async fn disconnect(&mut self, name: &str) -> Result<()> {
         let container_id = self.id().into();
         let network_disconnect_request = NetworkDisconnectRequest {
@@ -113,6 +115,7 @@ where
         Ok(())
     }
 
+    /// Force the container to disconnect from the network `ǹame`
     pub async fn force_disconnect(&mut self, name: &str) -> Result<()> {
         let container_id = self.id().into();
         let network_disconnect_request = NetworkDisconnectRequest {

testcontainers/src/core/image/image_ext.rs

@@ -69,7 +69,7 @@ pub trait ImageExt<I: Image> {
     /// Sets the network the container will be connected to.
     fn with_network(self, network: impl Into<String>) -> ContainerRequest<I>;
 
-    // Adds the specified network alias to the container.
+    /// Add the specified network alias to the container.
     fn with_net_alias(self, network_alias: impl Into<String>) -> ContainerRequest<I>;
 
     /// Adds the specified label to the container.
@@ -252,6 +252,7 @@ impl<RI: Into<ContainerRequest<I>>, I: Image> ImageExt<I> for RI {
         }
     }
 
+    /// Add the specified network alias to the container.
     fn with_net_alias(self, network_alias: impl Into<String>) -> ContainerRequest<I> {
         let mut container_req = self.into();
         container_req.network_aliases.insert(network_alias.into());