tweak formatting in README.md and expand some info

specifically on raising issues including necessary information to
make the issue easier to debug