updated documentation, fixed inconsistencies in readme