update doc: fix typos + compile messages