tweaks following feedback from @sospirited

ongoing fixes

adding github links

more tweaks