diff --git a/src/client.rs b/src/client.rs
index 379b66a..2ebc425 100644
--- a/src/client.rs
+++ b/src/client.rs
@@ -67,6 +67,8 @@ impl Client {
 
     /// High-level method make new async request to given [Uri](https://docs.gtk.org/glib/struct.Uri.html),
     /// callback with new `Response`on success or `Error` on failure
+    /// * compatible with user (certificate) and guest (certificate-less) connection types
+    /// * disables default `session-resumption-enabled` property to apply certificate change ability in runtime
     pub fn request_async(
         &self,
         uri: Uri,
diff --git a/src/client/connection.rs b/src/client/connection.rs
index 4768642..2fe369d 100644
--- a/src/client/connection.rs
+++ b/src/client/connection.rs
@@ -86,6 +86,7 @@ impl Connection {
     /// Get [IOStream](https://docs.gtk.org/gio/class.IOStream.html)
     /// for [SocketConnection](https://docs.gtk.org/gio/class.SocketConnection.html)
     /// or [TlsClientConnection](https://docs.gtk.org/gio/iface.TlsClientConnection.html) (if available)
+    /// * compatible with user (certificate) and guest (certificate-less) connection types
     /// * useful also to keep `Connection` active in async I/O context
     pub fn stream(&self) -> impl IsA<IOStream> {
         // * do not replace with `tls_client_connection.base_io_stream()`