added better documentation strings and improved Sphinx html page