[api][docs] improve docs