documentation: fix typos, re-articulate example