Documentation needs to be reviewed and updated

[mhucka]

What is the task?

Recent changes may have implications for the documentation. We should go through the docs and update them as needed.

(Optional) Do you have ideas or preferences for the approach?

No response

How urgent is this for you?

P1 – needed by the next release