add github shorthand, confirmation, and some TBDs