add default link to html doc and source code
reformat doc to fit sphinx formatting (reStructuredText)