docs: updates after user testing to github.md

docs: updates after user testing to github.md #238