Add an FAQ page to teh docs

2 files changed, 18 insertions, 0 deletions

diff --git a/docs/faq.rst b/docs/faq.rst
new file mode 100644
index 000000000..9c8dff962
--- /dev/null
+++ b/docs/faq.rst
@@ -0,0 +1,17 @@
+Frequently Asked Questions
+==========================
+
+How does ``cryptography`` compare to NaCl (Networking and Cryptography library)?
+--------------------------------------------------------------------------------
+
+While ``cryptography`` and `NaCl`_ both share the goal of making cryptography
+easier, and safer, to use for developers, ``cryptography`` is designed to be a
+general purpose library, capable of interoperating with existing systems, while
+NaCl features a collection of hand selected algorithms.
+
+``cryptography``'s recipes layer is similar in design to NaCl.
+
+If you prefer NaCl's design, we highly recommend `PyNaCl`_.
+
+.. _`NaCl`: http://nacl.cr.yp.to/
+.. _`PyNaCl`: https://pynacl.readthedocs.org
diff --git a/docs/index.rst b/docs/index.rst
index c8ef41b66..0cf09c625 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -60,6 +60,7 @@ The recipes layer
     fernet
     random-numbers
     exceptions
+    faq
     glossary
 
 The hazardous materials layer