removed unused buildout script
fixed errors in documentation generation
updated NEWS
added module/package docstrings
added documentation hint to readme