View Controllers: add additional documentation for ViewController

Add additional discussion on the various methods and properties for the
`ViewController` type.  This is primarily motivated by trying to correct
the default values for the type properties.

Author: compnerd