good doc comments for buy_policy