add some user documentation
fix typos
Merge branch 'task/documentation'