Rename all text files that are actually reStructuredText to .rst

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/>`_)