streamline docu and typehinting