Update REST API documentation for user namespaces

[#82838924]
Fix markdown typo
Improve documentation of bind mounts

[#83769328]

Signed-off-by: Steve Powell <spowell@pivotal.io>