aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/faq.rst17
-rw-r--r--docs/index.rst1
2 files changed, 18 insertions, 0 deletions
diff --git a/docs/faq.rst b/docs/faq.rst
new file mode 100644
index 00000000..9c8dff96
--- /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 c8ef41b6..0cf09c62 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