use pry
remove old examples
move design doc into doc/, flesh out and fix a bit