Start a branch for updating the docs

cc @esacteksab feel free to commit directly to this branch or send PRs to it