improved documentation here and there
removed some experimental methods