more work on the writeup