updated docs according to the last changes