1 files changed, 9 insertions, 0 deletions
diff --git a/README.rst b/README.rst
index 8462504..751a524 100644
--- a/README.rst
+++ b/README.rst
@@ -110,6 +110,15 @@ for more details.
 >>> for i in range(1000):
 ...     producer.send('foobar', b'msg %d' % i)
 
+Thread safety
+*************
+
+The KafkaProducer can be used across threads without issue, unlike the
+KafkaConsumer which cannot.
+
+While it is possible to use the KafkaConsumer in a thread-local manner,
+multiprocessing is recommended.
+
 Compression
 ***********