Adds documentation to category and ISHPermissionRequestViewController
Fixes typos and introduces wording changes. Adds minor code refactorings.
Merge pull request #3 from iosphere/documentation/category-requestVC

Adds documentation to category and ISHPermissionRequestViewController