Update docs with images and better wording (do not merge)

Sourced from pre existing documentation

Pending internal review. cc @mateusz