docs: many fixes

Signed-off-by: Yoan Blanc <yoan.blanc@cern.ch>