[docs] update readme to include allowEmpty and primary goal