updates for scenario doc