[docs] improve documentaton layout
[docs] fix docstrings