more fixes to documentations