adding official writeup w/ outline