Improve docs: permissions

again, check my beginner code.
Merge pull request #1296 from KristerV/patch-2

Improve docs: permissions