fix typos
update commented design question