documentation fix + improvement