updated readme and reworked some files for readability