add link to pep8 and sphinx in section about naming and documentation
fix reference link
fix html_static_path as the directory style was remove I use theming
escape some * characters