Add docs for Permissions and View Permissions

[bcantoni]

Add docs to match code changes from #429 and #526

[bcantoni]

#528 added a bunch of the permission-related docs, but I can spot a few errors there that will need to be reviewed and corrected.