diff --git a/doc/api/tls.markdown b/doc/api/tls.markdown
index 8e64bc98a0..f105614962 100644
--- a/doc/api/tls.markdown
+++ b/doc/api/tls.markdown
@@ -764,6 +764,10 @@ of written data and all required TLS negotiation.
 This instance implements a duplex [Stream][] interfaces.  It has all the
 common stream methods and events.
 
+Methods that return TLS connection meta data (e.g.
+[getPeerCertificate](#tlssocketgetpeercertificate-detailed-))
+will only return data while the connection is open.
+
 ### Event: 'secureConnect'
 
 This event is emitted after a new connection has been successfully handshaked.