Improve documentation with all the recently added features

[EdwardMoyse]

A lot of new functionality has been added and we need to update all the documentation to match. I will update this ticket with specific items but I wanted the placeholder in place so as not to forget.