updated documentation, inconsistencies in readme