diff --git a/MANIFEST.in b/MANIFEST.in
index 785552bb2f2eda15b0b76f9ce3b642c08861116d..a619f4727691d71512a6a5b6825916f569f36eba 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,5 +1,3 @@
-include README.rst bootstrap-buildout.py buildout.cfg develop.cfg COPYING version.txt requirements.txt
-recursive-include doc *.py *.rst
+include README.rst buildout.cfg develop.cfg COPYING version.txt requirements.txt
+recursive-include doc *.py *.rst *.ico *.png
 recursive-include scripts-article *.py *.rst
-include scripts-article/README
-include doc/img/*
diff --git a/scripts-article/README b/scripts-article/README
deleted file mode 100644
index 818bb83b0b4a89ef05606943e2f3c1521a96725f..0000000000000000000000000000000000000000
--- a/scripts-article/README
+++ /dev/null
@@ -1,33 +0,0 @@
-In this folder, you can find the scripts that have been used to generate the results in the article.
-
-they assume that the path to the database is either 'hci' or 'cohface' in the package root folder (this could be a symlink though)
-
----------------------------------------------
-
-chrom-cohface-clean-natural.py          --> Table 7 column 2 
-chrom-cohface-clean.py                  --> Table 5, line 2
-chrom-cohface-complete-face.py          --> Table 8, column 1, line 2
-chrom-cohface-complete-mask.py          --> Table 8, column 3, line 2
-chrom-cohface-complete-skin.py          --> Table 8, column 2, line 2
-chrom-hci-cvpr14.py                     --> Table 2, column 2 
-chrom-hci-protocols.py                  --> Table 4, line 2 
-chrom-xdb-cohface-hci.py                --> Table 6, line 2, column 2
-chrom-xdb-hci-cohface.py                --> Table 6, line 1, column 2
-li-cohface-clean-natural.py             --> Table 7, column 1
-li-cohface-clean.py                     --> Table 5, line 1
-li-cohface-complete-mask.py             --> Table 8, line 1, column 3 
-li-cohface-complete-skin.py             --> Table 8, line 1, column 2 
-li-cohface-complete-wholeface.py        --> Table 8, line 1, column 1 
-li-hci-cvpr14.py                        --> Table 2, column 1 
-li-hci-protocols.py                     --> Table 4, line 1   
-li-xdb-cohface-hci.py                   --> Table 6, column 1, line 2
-li-xdb-hci-cohface.py                   --> Table 6, column 1, line 1 
-ssr-cohface-clean-natural.py            --> Table 7, column 3
-ssr-cohface-clean.py                    --> Table 5, line 3 
-ssr-hci-cvpr14.py                       --> Table 2, column 3 
-ssr-hci-protocols.py                    --> Table 4, line 3 
-ssr-xdb-cohface-hci.py                  --> Table 6, column 3, line 2
-ssr-xdb-hci-cohface.py                  --> Table 6, column 3, line 1
-ssr-cohface-complete-face.py            --> Table 8, line 3, column 1
-ssr-cohface-complete-skin.py            --> Table 8, line 3, column 2
-ssr-cohface-complete-mask.py            --> Table 8, line 3, column 3
diff --git a/scripts-article/README.rst b/scripts-article/README.rst
new file mode 100644
index 0000000000000000000000000000000000000000..7c0ae97dc9982e5cc25e71c308a091f762159f8f
--- /dev/null
+++ b/scripts-article/README.rst
@@ -0,0 +1,35 @@
+Scripts for generating article results
+--------------------------------------
+
+In this folder, you can find the scripts that have been used to generate the
+results in the article. They assume that the path to the database is either
+'hci' or 'cohface' in the package root folder (this could be a symlink
+though)::
+
+  chrom-cohface-clean-natural.py          --> Table 7 column 2
+  chrom-cohface-clean.py                  --> Table 5, line 2
+  chrom-cohface-complete-face.py          --> Table 8, column 1, line 2
+  chrom-cohface-complete-mask.py          --> Table 8, column 3, line 2
+  chrom-cohface-complete-skin.py          --> Table 8, column 2, line 2
+  chrom-hci-cvpr14.py                     --> Table 2, column 2
+  chrom-hci-protocols.py                  --> Table 4, line 2
+  chrom-xdb-cohface-hci.py                --> Table 6, line 2, column 2
+  chrom-xdb-hci-cohface.py                --> Table 6, line 1, column 2
+  li-cohface-clean-natural.py             --> Table 7, column 1
+  li-cohface-clean.py                     --> Table 5, line 1
+  li-cohface-complete-mask.py             --> Table 8, line 1, column 3
+  li-cohface-complete-skin.py             --> Table 8, line 1, column 2
+  li-cohface-complete-wholeface.py        --> Table 8, line 1, column 1
+  li-hci-cvpr14.py                        --> Table 2, column 1
+  li-hci-protocols.py                     --> Table 4, line 1
+  li-xdb-cohface-hci.py                   --> Table 6, column 1, line 2
+  li-xdb-hci-cohface.py                   --> Table 6, column 1, line 1
+  ssr-cohface-clean-natural.py            --> Table 7, column 3
+  ssr-cohface-clean.py                    --> Table 5, line 3
+  ssr-hci-cvpr14.py                       --> Table 2, column 3
+  ssr-hci-protocols.py                    --> Table 4, line 3
+  ssr-xdb-cohface-hci.py                  --> Table 6, column 3, line 2
+  ssr-xdb-hci-cohface.py                  --> Table 6, column 3, line 1
+  ssr-cohface-complete-face.py            --> Table 8, line 3, column 1
+  ssr-cohface-complete-skin.py            --> Table 8, line 3, column 2
+  ssr-cohface-complete-mask.py            --> Table 8, line 3, column 3