[docs] update against api changes