made api docs clearer