Minor updates to the doc on best practices
Prepared first public release
[docs] Made html_theme_path use absolute paths