small improvements to the documentation
work around encoding issue while capturing stdout
docs: add example result.html