Merge pull request #11 from alex/more-docs

More docs

1 files changed, 18 insertions, 0 deletions

diff --git a/docs/architecture.rst b/docs/architecture.rst
new file mode 100644
index 00000000..7b394950
--- /dev/null
+++ b/docs/architecture.rst
@@ -0,0 +1,18 @@
+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``. This is implemented on top of
+  ``cryptography.c``.
+* ``cryptography``: This package contains higher level recipes, for example
+  "encrypt and then MAC". This is implemented on top of
+  ``cryptography.primitives``.