[docs] mention latest changes in the README
[docs] fix typos in the doc block
[docs] remove private classes from docs