Update docs readme

Inspired by #793