Start to document the architecture.

1 files changed, 16 insertions, 0 deletions

diff --git a/docs/architecture.rst b/docs/architecture.rst
new file mode 100644
index 00000000..80e2c28a
--- /dev/null
+++ b/docs/architecture.rst
@@ -0,0 +1,16 @@
+Architecture
+============
+
+.. warning::
+
+    Because ``cryptography`` is so young, much of this document is
+    aspirational, rather than documentation.
+
+``cryptography`` has three different layers:
+
+* ``cryptography.c``: This package contains bindings to low level cryptographic
+  libraries. Our initial target will be OpenSSL.
+* ``cryptography.primitives``: This packages contains low level algorithms,
+  things like ``AES`` or ``SHA1``.
+* ``cryptography``: This package contains higher level recipes, for example
+  "encrypt and then MAC".