more api docs improvements