aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorHynek Schlawack <hs@ox.cx>2013-08-11 06:16:47 -0700
committerHynek Schlawack <hs@ox.cx>2013-08-11 06:16:47 -0700
commitf0091d0f4c12177eec3216567eae229cf694e320 (patch)
tree7ad31b9be27ea2315d3b1ed9bde8336f1615fb00 /docs
parent32d136ef394dcb25a816b0aa76ce2cc113638734 (diff)
parentf0d139aa2d9d194dcf7ace775053039e0724bb11 (diff)
downloadcryptography-f0091d0f4c12177eec3216567eae229cf694e320.tar.gz
cryptography-f0091d0f4c12177eec3216567eae229cf694e320.tar.bz2
cryptography-f0091d0f4c12177eec3216567eae229cf694e320.zip
Merge pull request #38 from alex/why-cryptography
Better describe why this library exists. Refs #5
Diffstat (limited to 'docs')
-rw-r--r--docs/index.rst19
1 files changed, 18 insertions, 1 deletions
diff --git a/docs/index.rst b/docs/index.rst
index 1d8ffda6..29f0b545 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,7 +8,24 @@ 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.
+* Extremely error prone APIs, and bad defaults.
+
+
+Contents
+--------
.. toctree::
:maxdepth: 2