diff --git a/docs/secret.rst b/docs/secret.rst index a2149aaa54cf3af562d685e4d9071ff494f49232..b11f37c45c52d67795e0b122fdbaadf5b5f377b0 100644 --- a/docs/secret.rst +++ b/docs/secret.rst @@ -3,10 +3,11 @@ Secret Key Encryption .. currentmodule:: nacl.secret -Secret key encryption is analogous to a safe. You can store something secret -through it and anyone who has the key can open it and view the contents. -:class:`~nacl.secret.SecretBox` functions as just such a safe, and like any -good safe any attempts to tamper with the contents is easily detected. +Secret key encryption (also called symmetric key encryption) is analogous to a +safe. You can store something secret through it and anyone who has the key can +open it and view the contents. :class:`~nacl.secret.SecretBox` functions as +just such a safe, and like any good safe any attempts to tamper with the +contents is easily detected. Secret Key Encryption allows you to store or transmit data over insecure channels without leaking the contents of that message, nor anything about it