Docs updates

@zoni This should be right up your alley.
I already pushed edd587c which adds this. For some reason Github is just not picking this up as an outdated diff.