repo readme describes subdirectories
readmes updated and minor file organization