Better describe why this library exists. Refs #5

1 files changed, 13 insertions, 0 deletions

diff --git a/docs/index.rst b/docs/index.rst
index 1d8ffda6..a061b3e7 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,6 +8,19 @@ Welcome to ``cryptography``
 ``cryptography`` is a Python library which exposes cryptographic primitives and
 recipes.
 
+Why a new crypto library for Python?
+------------------------------------
+
+We wanted to address a few issues with existing cryptography libraries in
+Python:
+
+* Lack of PyPy support
+* Lack of maintenance
+* Use poor implementations of algorithms (i.e. ones with known side-channel
+  attacks)
+* Lack of high level, "Cryptography for humans", APIs
+
+
 Contents:
 
 .. toctree::