docs: clarify thread safety of immutable objects

pyca · Mar 4, 2025 · 002127b · 002127b
1 parent 34dfbbc
commit 002127b
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/docs/index.rst b/docs/index.rst
@@ -45,6 +45,16 @@ See :doc:`Installation <installation>` for more information.
 .. _cryptography-layout:
 
 
+Thread Safety
+-------------
+
+All immutable objects in ``cryptography`` are safe to use in multithreaded
+environments. This means they can be shared across threads without requiring
+additional synchronization. Mutable objects, such as hash contexts, can also be
+shared, but concurrent modification may lead to undefined behavior or
+exceptions. When working with cryptographic operations in a multithreaded
+application, ensure that any mutable objects are used in a thread-safe manner.
+
 Layout
 ------