flesh out readme, add design notes