"read me" updates