merged writeup with README