improved doc - part1