started writing a designdoc; removed some redundant TODO text;