try to improve the doc a bit: https://github.com/github/developer.github.com/pull/460