Improve documentation for github / humans