improving docs a bit

[skip ci]