tweaked docs and added html docs example
doc tweaks