readme fixes and image additions
Fix some rst syntax error messages and refresh html docs.