[docs] patch up docs to accomodate new handbook