update doc to reflect findPromotion