Update docs to reflect the current state (new features & changes)
This will reduce the need for: - #920 - #662 - #833