[docs] use our own script to generate rst files
[docs] improve docstring formatting