fixed up major parts and set the stage for updates
made README markdown