better docs, gh_pages and code cleanup