fixing documentation and broken stuff