Update the docs

[markmacgillivray]

creating a ticket to record that etienne is adding to the docs this week.

[markmacgillivray]

most already done, we should check over then close this ticket.