adding some info about handling errors. some spacing updates