Document KafkaAdmin class

Author: jeffwidman

docs/apidoc/KafkaAdmin.rst

@@ -0,0 +1,5 @@
+KafkaAdmin
+===========
+
+.. autoclass:: kafka.admin.KafkaAdmin
+    :members:

docs/apidoc/modules.rst

@@ -5,6 +5,7 @@ kafka-python API
 
    KafkaConsumer
    KafkaProducer
+   KafkaAdmin
    KafkaClient
    BrokerConnection
    ClusterMetadata

kafka/admin/kafka.py

@@ -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.