add permissions documentation and ISO 639-1

fixes issues #27 and #28