started with docs

README.md

 CoolAMQP
 ========
+[![Documentation Status](https://readthedocs.org/projects/coolamqp/badge/?version=latest)](http://coolamqp.readthedocs.io/en/latest/?badge=latest)
 [![PyPI version](https://badge.fury.io/py/CoolAMQP.svg)](https://badge.fury.io/py/CoolAMQP)
 [![Build Status](https://travis-ci.org/smok-serwis/coolamqp.svg)](https://travis-ci.org/smok-serwis/coolamqp)
 [![Code Climate](https://codeclimate.com/github/smok-serwis/coolamqp/badges/gpa.svg)](https://codeclimate.com/github/smok-serwis/coolamqp)
@@ -10,6 +11,8 @@ CoolAMQP
 
 A **magical** AMQP client, that uses **heavy sorcery** to achieve speeds that other AMQP clients cannot even hope to match.
 
+Documentation (WIP) is available at [Read the Docs](http://coolamqp.readthedocs.io/).
+
 tl;dr - [this](coolamqp/framing/definitions.py) is **machine-generated** compile-time.
 [this](coolamqp/framing/compilation/content_property.py) **generates classes run-time**,
 and there are memoryviews **_everywhere_**. 

docs/conf.py

@@ -19,7 +19,11 @@
 # import os
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
+from recommonmark.parser import CommonMarkParser
 
+source_parsers = {
+    '.md': CommonMarkParser
+}
 
 # -- General configuration ------------------------------------------------
 
@@ -53,9 +57,9 @@ author = u'DMS Serwis s.c.'
 # built documents.
 #
 # The short X.Y version.
-version = u'0.9 series'
+version = '0.89'
 # The full version, including alpha/beta/rc tags.
-release = u'0.9 series'
+release = u'0.89-latest'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/index.rst

@@ -10,6 +10,7 @@ Welcome to CoolAMQP's documentation!
    :maxdepth: 2
    :caption: Contents:
 
+   tutorial
 
 
 Indices and tables

docs/tutorial.md

+# Tutorial
+
+If you want to connect to an AMQP broker, you need:
+* it's address (and port)
+* login and password
+* name of the virtual host
+
+An idea of a heartbeat interval would be good, but you can do without. Since CoolAMQP will support clusters
+in the future, you should define the nodes first. You can do it using _NodeDefinition_.
+See NodeDefinition's documentation for alternative ways to do this, but here we will use
+the AMQP connection string.
+
+```python
+from coolamqp.objects import NodeDefinition
+
+node = NodeDefinition('amqp://user@password:host/vhost')
+```
+
+_Cluster_ instances are used to interface with the cluster (or a single broker). It
+accepts a list of nodes:
+
+```python
+from coolamqp.clustering import Cluster
+cluster = Cluster([node])
+cluster.start(wait=True)
+```
+
+_wait=True_ will block until connection is completed. After this, you can use other methods.
\ No newline at end of file