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
That mirrors Apple's spelling.