docs cont.

README.rst

@@ -3,6 +3,14 @@ PyOTRS
 
 [![build status](https://gitlab.denm.de/robbie/PyOTRS/badges/master/build.svg)](https://gitlab.denm.de/robbie/PyOTRS/commits/master)
 
+Brief description..
+
+Features
+--------
+
+- OTRS REST API for python
+
+
 
 Import
 ------
@@ -32,12 +40,14 @@ u'Welcome to OTRS!'
 >>> my_ticket.to_dct()  # Show complete ticket
 
 - add an ``Article`` to ``Ticket`` with ID 1
+
 >>> my_article = Article({"Subject": "Subj", "Body": "New Body"})
 >>> client.ticket_update(1, article=my_article)
 True
 
 
 - get Articles and Attachments
+
 >>> client.ticket_get_by_id(1, articles=1, attachments=1)  # include Articles and Attachments
 >>> my_ticket = client.result_list_ticket_get[0]
 
@@ -57,13 +67,13 @@ Useful result data
 
 Tips
 ----
-**ipython**
 
-```
-import sys
-reload(sys)
-sys.setdefaultencoding('utf-8')
-```
+**ipython**::
+
+  import sys
+  reload(sys)
+  sys.setdefaultencoding('utf-8')
+
 
 Full Docs
 ---------

docs/overview.rst

-Overview
-========
-
-Brief description..
-
-Features
---------
-
-   * OTRS REST API for python

docs/readme.rst

+.. include:: ../README.rst

docs_cov_build_deploy.sh

@@ -14,3 +14,5 @@ tox -e docs
 #sudo cp -a docs/build /var/www/PyOTRS/docs
 sudo cp -a build/docs /var/www/PyOTRS/docs
 
+# check format (README)
+python setup.py check --strict --metadata --restructuredtext

tox.ini

@@ -92,7 +92,7 @@ deps =
     sphinx
     sphinxcontrib-napoleon
     sphinx_rtd_theme
-    pygments
 
 commands =
-    sphinx-build -b html {toxinidir}/docs/ {toxinidir}/build/docs/
+    # sphinx-build -b html {toxinidir}/docs/ {toxinidir}/build/docs/
+    sphinx-build -b dirhtml {toxinidir}/docs/ {toxinidir}/build/docs/