aboutsummaryrefslogtreecommitdiffstats
path: root/doc/reading.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/reading.rst')
-rw-r--r--doc/reading.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/reading.rst b/doc/reading.rst
new file mode 100644
index 000000000..3b3545e28
--- /dev/null
+++ b/doc/reading.rst
@@ -0,0 +1,23 @@
+
+Recommended Reading
+========================================
+
+It's a very good idea if you have some knowledge of cryptography
+*before* trying to use the library. This is an area where it is very
+easy to make mistakes, and where things are often subtle and/or
+counterintuitive. Obviously the library tries to provide things at a
+high level precisely to minimize the number of ways things can go
+wrong, but naive use will almost certainly not result in a secure
+system.
+
+Especially recommended are:
+
+- *Cryptography Engineering*
+ by Niels Ferguson, Bruce Schneier, and Tadayoshi Kohno
+
+- *Security Engineering -- A Guide to Building Dependable Distributed Systems*
+ by Ross Anderson
+
+- *Handbook of Applied Cryptography*
+ by Alfred J. Menezes, Paul C. Van Oorschot, and Scott A. Vanstone
+ (`available online <http://www.cacr.math.uwaterloo.ca/hac/>`_)