more documentation & code cleanliness refactors
Code fix with respect to how subdirectory entries are returned & some better error messages