diff --git a/packages/@aws-cdk/core/README.md b/packages/@aws-cdk/core/README.md
index 0e0b38943a803..adac3034f10c1 100644
--- a/packages/@aws-cdk/core/README.md
+++ b/packages/@aws-cdk/core/README.md
@@ -428,6 +428,7 @@ stack-unique identifier and returns the service token:
 const serviceToken = CustomResourceProvider.getOrCreate(this, 'Custom::MyCustomResourceType', {
   codeDirectory: `${__dirname}/my-handler`,
   runtime: CustomResourceProviderRuntime.NODEJS_12, // currently the only supported runtime
+  description: "Lambda function created by custom resource provider",
 });
 
 new CustomResource(this, 'MyResource', {