Readme Update

Updating the Readme with new bugs/known issues and a reorganization of
the file structure.