Adds documentation for main view controller and request class

Also fixes the return value in delegate method and removes unused enum value for permission state
"determining if" -> "determining whether"
"regaring" -> "regarding"