Add Permissions API docs

[stivendarsi]

Not sure if people even need a Permissions documentation, but since there are multiple ways to manage your plugin's permission I thought it could be useful to know what way could suit you needs best. Also a brief explanation on how permissions are handled on the server side could be nice.