Began writing a glossary

2 files changed, 30 insertions, 0 deletions

diff --git a/docs/glossary.rst b/docs/glossary.rst
new file mode 100644
index 00000000..b80b4b2b
--- /dev/null
+++ b/docs/glossary.rst
@@ -0,0 +1,29 @@
+Glossary
+========
+
+.. glossary::
+
+    plaintext
+        User-readable data you care about.
+
+    ciphertext
+        The encoded data, it's not user readable. Potential attackers are able
+        to see this.
+
+    encryption
+        The process of converting plaintext to ciphertext.
+
+    decryption
+        The process of converting ciphertext to plaintext.
+
+    key
+        Secret data is encoded with a function using this key. Sometimes
+        multiple keys are used.
+
+    symmetric cryptography
+        Cryptographic operations where encryption and decryption use the same
+        key.
+
+    asymmetric cryptography
+        Cryptographic operations where encryption and decryption use different
+        keys. There are seperate encryption and decryption keys.
diff --git a/docs/index.rst b/docs/index.rst
index eb30b5dd..1b88e24e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -32,6 +32,7 @@ Contents
 
     architecture
     exceptions
+    glossary
     contributing
     security
     community