diff --git a/cassandra/cluster.py b/cassandra/cluster.py
index 2c5e45c3..b0d7dcc0 100644
--- a/cassandra/cluster.py
+++ b/cassandra/cluster.py
@@ -1077,10 +1077,14 @@ class Cluster(object):
     def refresh_schema(self, keyspace=None, table=None, usertype=None, max_schema_agreement_wait=None):
         """
         Synchronously refresh the schema metadata.
-        By default timeout for this operation is governed by :attr:`~.Cluster.max_schema_agreement_wait`
+
+        By default, the timeout for this operation is governed by :attr:`~.Cluster.max_schema_agreement_wait`
         and :attr:`~.Cluster.control_connection_timeout`.
+        
         Passing max_schema_agreement_wait here overrides :attr:`~.Cluster.max_schema_agreement_wait`.
+        
         Setting max_schema_agreement_wait <= 0 will bypass schema agreement and refresh schema immediately.
+        
         An Exception is raised if schema refresh fails for any reason.
         """
         if not self.control_connection.refresh_schema(keyspace, table, usertype, max_schema_agreement_wait):
diff --git a/docs/api/cassandra/cluster.rst b/docs/api/cassandra/cluster.rst
index 2d6a5342..f0a9a312 100644
--- a/docs/api/cassandra/cluster.rst
+++ b/docs/api/cassandra/cluster.rst
@@ -39,6 +39,8 @@
 
    .. autoattribute:: control_connection_timeout
 
+   .. autoattribute:: idle_heartbeat_interval
+
    .. automethod:: connect
 
    .. automethod:: shutdown
@@ -57,6 +59,8 @@
 
    .. automethod:: set_max_connections_per_host
 
+   .. automethod:: refresh_schema
+
 .. autoclass:: Session ()
 
    .. autoattribute:: default_timeout