[docs] some more writing