README / docs updates re compatibility and CLI release

Author: dpkp

README.rst

@@ -22,22 +22,11 @@ Python client for the Apache Kafka distributed stream processing system.
 kafka-python is designed to function much like the official java client, with a
 sprinkling of pythonic interfaces (e.g., consumer iterators).
 
-kafka-python is best used with newer brokers (0.9+), but is backwards-compatible with
-older versions (to 0.8.0). Some features will only be enabled on newer brokers.
-For example, fully coordinated consumer groups -- i.e., dynamic partition
-assignment to multiple consumers in the same group -- requires use of 0.9+ kafka
-brokers. Supporting this feature for earlier broker releases would require
-writing and maintaining custom leadership election and membership / health
-check code (perhaps using zookeeper or consul). For older brokers, you can
-achieve something similar by manually assigning different partitions to each
-consumer instance with config management tools like chef, ansible, etc. This
-approach will work fine, though it does not support rebalancing on failures.
-See https://kafka-python.readthedocs.io/en/master/compatibility.html
-for more details.
-
 Please note that the master branch may contain unreleased features. For release
 documentation, please see readthedocs and/or python's inline help.
 
+New in 2.3 release: python -m kafka.* interfaces for quick scripts and testing.
+
 .. code-block:: bash
 
     $ pip install kafka-python
@@ -188,6 +177,14 @@ for more details.
     metrics = producer.metrics()
 
 
+Module CLI Interface
+********************
+
+kafka-python also provides simple command-line interfaces for consumer, producer, and admin clients.
+Access via ``python -m kafka.consumer``, ``python -m kafka.producer``, and ``python -m kafka.admin``.
+See https://kafka-python.readthedocs.io/en/master/usage.html for more details.
+
+
 Thread safety
 *************
 

docs/compatibility.rst

@@ -13,8 +13,8 @@ Because the kafka server protocol is backwards compatible, kafka-python is
 expected to work with newer broker releases as well.
 
 Although kafka-python is tested and expected to work on recent broker versions,
-not all features are supported. Specifically, transactional producer/consumer
-support is not fully implemented. PRs welcome!
+not all features are supported. Please see github open issues for feature tracking.
+PRs welcome!
 
 kafka-python is tested on python 2.7, and 3.8-3.13.
 

docs/index.rst

@@ -16,21 +16,11 @@ Python client for the Apache Kafka distributed stream processing system.
 kafka-python is designed to function much like the official java client, with a
 sprinkling of pythonic interfaces (e.g., consumer iterators).
 
-kafka-python is best used with newer brokers (0.9+), but is backwards-compatible with
-older versions (to 0.8.0). Some features will only be enabled on newer brokers.
-For example, fully coordinated consumer groups -- i.e., dynamic
-partition assignment to multiple consumers in the same group -- requires use of
-0.9 kafka brokers. Supporting this feature for earlier broker releases would
-require writing and maintaining custom leadership election and membership /
-health check code (perhaps using zookeeper or consul). For older brokers, you
-can achieve something similar by manually assigning different partitions to
-each consumer instance with config management tools like chef, ansible, etc.
-This approach will work fine, though it does not support rebalancing on
-failures.  See `Compatibility <compatibility.html>`_ for more details.
-
 Please note that the master branch may contain unreleased features. For release
 documentation, please see readthedocs and/or python's inline help.
 
+New in 2.3 release: python -m kafka.* interfaces for quick scripts and testing.
+
 .. code:: bash
 
     pip install kafka-python