aboutsummaryrefslogtreecommitdiffstats
path: root/docs/index.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/index.rst')
-rw-r--r--docs/index.rst18
1 files changed, 17 insertions, 1 deletions
diff --git a/docs/index.rst b/docs/index.rst
index 1d8ffda6..49e7b29e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,7 +8,23 @@ Welcome to ``cryptography``
``cryptography`` is a Python library which exposes cryptographic primitives and
recipes.
-Contents:
+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 of poor implementations of algorithms (i.e. ones with known side-channel
+ attacks)
+* Lack of high level, "Cryptography for humans", APIs
+* Absence of algorithms such as AES-GCM
+* Poor introspectability, and thus poor testability
+
+
+Contents
+--------
.. toctree::
:maxdepth: 2