document promotion behaviors