chore: Add remarks

Author: HofmeisterAn

src/Testcontainers/Configurations/WaitStrategies/IWaitForContainerOS.cs

@@ -82,6 +82,17 @@ public interface IWaitForContainerOS
     /// Waits until a TCP port is available from the test host to the container.
     /// This verifies that the port is exposed and reachable externally.
     /// </summary>
+    /// <remarks>
+    /// This does not necessarily mean that the TCP connection to the service running inside
+    /// the container was successful. For container runtimes like Docker Desktop, Podman, or similar,
+    /// this usually only indicates that the port has been mapped and that a connection could be
+    /// established to the host-side proxy that maps the port.
+    ///
+    /// This wait strategy is particularly useful for container runtimes that may take some time
+    /// to finish setting up port mappings. In some cases, other strategies such as log-based
+    /// readiness checks may indicate readiness before the runtime has fully configured the port
+    /// mapping, leading to connection failures. This strategy helps to avoid that race condition.
+    /// </remarks>
     /// <param name="containerPort">The TCP port of the service running inside the container.</param>
     /// <param name="waitStrategyModifier">The wait strategy modifier to cancel the readiness check.</param>
     /// <returns>A configured instance of <see cref="IWaitForContainerOS" />.</returns>