read me: improved readability