added more api docs