Updated authorization documentation.
Updated authorization documentation.

Added information about the distinction between roles and principals, as well as
a real-world authorization example.

Review: https://reviews.apache.org/r/43199/

dforsyth/mesos,yuquanshan/customizedMesos,gsantovena/mesos,reneploetz/mesos,dforsyth/mesos,chhsia0/mesos,dforsyth/mesos,Gilbert88/mesos,verizonlabs/mesos,gsantovena/mesos,craimbert/mesos,verizonlabs/mesos,reneploetz/mesos,neilconway/mesos,andschwa/mesos,kaysoky/mesos,zmalik/mesos,zmalik/mesos,Gilbert88/mesos,abudnik/mesos,gsantovena/mesos,andschwa/mesos,chhsia0/mesos,craimbert/mesos,asamerh4/mesos,zmalik/mesos,kaysoky/mesos,gsantovena/mesos,chhsia0/mesos,asamerh4/mesos,asamerh4/mesos,andschwa/mesos,jpeach/mesos,craimbert/mesos,Gilbert88/mesos,gsantovena/mesos,reneploetz/mesos,abudnik/mesos,verizonlabs/mesos,jpeach/mesos,yuquanshan/customizedMesos,chhsia0/mesos,yuquanshan/customizedMesos,craimbert/mesos,abudnik/mesos,yuquanshan/customizedMesos,zmalik/mesos,andschwa/mesos,kaysoky/mesos,Gilbert88/mesos,yuquanshan/customizedMesos,asamerh4/mesos,abudnik/mesos,neilconway/mesos,verizonlabs/mesos,zmalik/mesos,reneploetz/mesos,kaysoky/mesos,Gilbert88/mesos,yuquanshan/customizedMesos,dforsyth/mesos,Aman-Jain-14/customizedMesos,Aman-Jain-14/customizedMesos,zmalik/mesos,andschwa/mesos,neilconway/mesos,neilconway/mesos,abudnik/mesos,andschwa/mesos,jpeach/mesos,kaysoky/mesos,dforsyth/mesos,Aman-Jain-14/customizedMesos,zmalik/mesos,abudnik/mesos,yuquanshan/customizedMesos,gsantovena/mesos,reneploetz/mesos,gsantovena/mesos,Gilbert88/mesos,neilconway/mesos,jpeach/mesos,Aman-Jain-14/customizedMesos,asamerh4/mesos,asamerh4/mesos,jpeach/mesos,jpeach/mesos,chhsia0/mesos,dforsyth/mesos,verizonlabs/mesos,Gilbert88/mesos,chhsia0/mesos,craimbert/mesos,abudnik/mesos,kaysoky/mesos,jpeach/mesos,dforsyth/mesos,neilconway/mesos,neilconway/mesos,Aman-Jain-14/customizedMesos,verizonlabs/mesos,kaysoky/mesos,Aman-Jain-14/customizedMesos,asamerh4/mesos,Aman-Jain-14/customizedMesos,reneploetz/mesos,andschwa/mesos,craimbert/mesos,verizonlabs/mesos,chhsia0/mesos,reneploetz/mesos,craimbert/mesos