add some detail on github

I think this a pretty solid change.