dpkp
diff --git a/‎docs/apidoc/KafkaAdmin.rst
Copy file name to clipboard
+5Lines changed: 5 additions & 0 deletions b/‎docs/apidoc/KafkaAdmin.rst
Copy file name to clipboard
+5Lines changed: 5 additions & 0 deletions
diff --git a/‎docs/apidoc/modules.rst
Copy file name to clipboardExpand all lines: docs/apidoc/modules.rst
+1Lines changed: 1 addition & 0 deletions b/‎docs/apidoc/modules.rst
Copy file name to clipboardExpand all lines: docs/apidoc/modules.rst
+1Lines changed: 1 addition & 0 deletions
diff --git a/‎kafka/admin/kafka.py
Copy file name to clipboardExpand all lines: kafka/admin/kafka.py
+7Lines changed: 7 additions & 0 deletions b/‎kafka/admin/kafka.py
Copy file name to clipboardExpand all lines: kafka/admin/kafka.py
+7Lines changed: 7 additions & 0 deletions
@@ -0,0 +1,5 @@
+KafkaAdmin
+===========
+
+.. autoclass:: kafka.admin.KafkaAdmin
+    :members:
@@ -5,6 +5,7 @@ kafka-python API
 
    KafkaConsumer
    KafkaProducer
+   KafkaAdmin
    KafkaClient
    BrokerConnection
    ClusterMetadata
@@ -18,6 +18,13 @@
 class KafkaAdmin(object):
     """An class for administering the kafka cluster.
 
+    Warning:
+        This is an unstable interface that was recently added and is subject to
+        change without warning. In particular, many methods currently return
+        raw protocol tuples. In future releases, we plan to make these into
+        nicer, more pythonic objects. Unfortunately, this will likely break
+        those interfaces.
+
     The KafkaAdmin class will negotiate for the latest version of each message protocol format supported
     by both the kafka-python client library and the kafka broker.  Usage of optional fields from protocol
     versions that are not supported by the broker will result in UnsupportedVersionError exceptions.