Cleaned up the docs for ECB
diff --git a/docs/primitives/symmetric-encryption.rst b/docs/primitives/symmetric-encryption.rst
index d0429d4..f028c75 100644
--- a/docs/primitives/symmetric-encryption.rst
+++ b/docs/primitives/symmetric-encryption.rst
@@ -72,11 +72,15 @@
Insecure Modes
--------------
-.. warning:: Do not use. This is an insecure mode.
+.. warning::
+
+ These modes are insecure. New applications should never make use of them,
+ and existing applications should strongly consider migrating away.
+
+
.. class:: cryptography.primitives.block.modes.ECB()
ECB (Electronic Code Book) is the simplest mode of operation for block
- ciphers. The data is separated into blocks and each block is encrypted
- separately. This means identical plaintext blocks will always result in
- identical encrypted blocks. Due to this property it is not recommended
- for use. Really, don't use it. Just. Don't.
+ ciphers. Each block of data is encrypted in the same way. This means
+ identical plaintext blocks will always result in identical ciphertext
+ blocks, and thus result in information leakage