Documentation updates

Some documentation updates, mainly clarifications or more detail