CDITCK-261 Update doc
- fix typos
- make some parts clearer