improve documentation part2