documentation improvements
initial import of hack caching.  still has some old namespace cruft that needs to be removed.
additional checks for views, simplifications