diff --git a/packages/aws-cdk-lib/core/README.md b/packages/aws-cdk-lib/core/README.md index d24d240503b7c..2b32f279b0ec3 100644 --- a/packages/aws-cdk-lib/core/README.md +++ b/packages/aws-cdk-lib/core/README.md @@ -1694,7 +1694,10 @@ values must be non-negative integers, where a higher number means the Aspect wil By default, newly created nodes always inherit aspects. Priorities are mainly for ordering between mutating aspects on the construct tree. -CDK provides standard priority values for mutating and readonly aspects to help ensure consistency across different construct libraries: +CDK provides standard priority values for mutating and readonly aspects to help ensure consistency across different construct libraries. +Note that Aspects that have same priority value are not guaranteed to be executed +in a consistent order. + ```ts /** diff --git a/packages/aws-cdk-lib/core/lib/aspect.ts b/packages/aws-cdk-lib/core/lib/aspect.ts index e8353264085ef..7e5289872f06a 100644 --- a/packages/aws-cdk-lib/core/lib/aspect.ts +++ b/packages/aws-cdk-lib/core/lib/aspect.ts @@ -40,7 +40,10 @@ export interface AspectOptions { * The priority value to apply on an Aspect. * Priority must be a non-negative integer. * - * @default - AspectPriority.DEFAULT + * Aspects that have same priority value are not guaranteed to be + * executed in a consistent order. + * + * @default AspectPriority.DEFAULT */ readonly priority?: number; }