Doc improvements
Intermediate checkin (broken).  The file resource will have its constructors changed.  This check in is for future reference to see why the change was made.
Move to a different way of creating the resources for files and directories.  This makes the API usage much more consistent.