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
Aw, American English? :uk: