some docs improvments