adding a howto file an issue page
more fixes and new |github| abbrevation