doc details improved