Design doc as of 7:40 PM Nov. 12

@isupeene Design doc as of 7:40 PM Nov. 12th. Can also be used as general discussion. Either one of us can merge this, just be sure that the design doc pdf is up to date when you do.