improved docuementation