From 3667e790fc7f6cd91a27a9a6d07e514ef98a5727 Mon Sep 17 00:00:00 2001
From: Alexandr Mansurov <alex@eghuro.cz>
Date: Sun, 17 Oct 2021 21:32:27 +0200
Subject: [PATCH] Usage docs

---
 README.rst     |  2 +-
 docs/usage.rst | 15 +++++++++++++--
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/README.rst b/README.rst
index 019eb2e..9502e62 100644
--- a/README.rst
+++ b/README.rst
@@ -15,7 +15,7 @@ Installation
 Usage
 ============
 
-You can use cryptbase with django ORM or witg SQLAlchemy.
+You can use cryptbase with django ORM or with SQLAlchemy.
 
 To use with SQLAlchemy:
 
diff --git a/docs/usage.rst b/docs/usage.rst
index 20dcd06..ecaeabc 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -2,6 +2,17 @@
 Usage
 =====
 
-To use cryptbase in a project::
+You can use cryptbase with django ORM or with SQLAlchemy.
 
-	import cryptbase
+To use with SQLAlchemy:
+
+    from cryptbase import EncryptedText
+    sensitive = Column(EncryptedText(key=DB_KEY))
+
+To use with django:
+
+    from cryptbase import EncryptedTextField
+    sensitive = EncryptedTextField(key=DB_KEY)
+
+DB_KEY is 32 bytes encryption key as hex encoded string. Fields behave as TEXT fields, data are transparently encrypted
+when storing into the database and decrypted on retrieval.