From 1c7840089af2feb4dde058ec6af2ae53713f17af Mon Sep 17 00:00:00 2001
From: Romain Dorgueil <romain@dorgueil.net>
Date: Sun, 14 Jan 2018 16:21:19 +0100
Subject: [PATCH] [docs] sqlalchemy basics and api ref.

---
 docs/extension/sqlalchemy.rst | 46 ++++++++++++++++++++++++++++++++---
 1 file changed, 42 insertions(+), 4 deletions(-)

diff --git a/docs/extension/sqlalchemy.rst b/docs/extension/sqlalchemy.rst
index bec1a49..8ee649c 100644
--- a/docs/extension/sqlalchemy.rst
+++ b/docs/extension/sqlalchemy.rst
@@ -16,19 +16,57 @@ To install the extension, use the `sqlalchemy` extra:
 
 .. note:: You can install more than one extra at a time separating the names with commas.
 
-Overview
-::::::::
+Overview and examples
+:::::::::::::::::::::
 
 There are two main tools provided by this extension. One reader, one writer.
 
+Let's select some data:
+
+.. code-block:: python
+
+    import bonobo
+    import bonobo_sqlalchemy
+
+    def get_graph():
+        graph = bonobo.Graph()
+        graph.add_chain(
+            bonobo_sqlalchemy.Select('SELECT * FROM example', limit=100),
+            bonobo.PrettyPrinter(),
+        )
+
+And let's insert some data:
+
+.. code-block:: python
+
+    import bonobo
+    import bonobo_sqlalchemy
+
+
+    def get_graph(**options):
+        graph = bonobo.Graph()
+        graph.add_chain(
+            ...,
+            bonobo_sqlalchemy.InsertOrUpdate('example')
+        )
+
+        return graph
 
-Details
-:::::::
 
 Reference
 :::::::::
 
+.. module:: bonobo_sqlalchemy
 
+Select
+------
+
+.. autoclass:: Select
+
+InsertOrUpdate
+--------------
+
+.. autoclass:: InsertOrUpdate
 
 Source code
 :::::::::::