Update: Add developer preview docs for CDK Toolkit Library

Author: evzzk

v2/cli.md

@@ -289,7 +289,7 @@ The CDK CLI actually runs your app and synthesizes fresh templates before most o
 
 See `cdk synth --help` for all available options\. A few of the most frequently used options are covered in the following section\.
 
-### Specify context values<a name="w94aac69c33c11"></a>
+### Specify context values<a name="w94aac73c33c11"></a>
 
 Use the `--context` or `-c` option to pass [runtime context](context.md) values to your CDK app\.
 
@@ -308,15 +308,15 @@ When deploying multiple stacks, the specified context values are normally passed
 cdk synth --context Stack1:key=value Stack2:key=value Stack1 Stack2
 ```
 
-### Specify display format<a name="w94aac69c33c13"></a>
+### Specify display format<a name="w94aac73c33c13"></a>
 
 By default, the synthesized template is displayed in YAML format\. Add the `--json` flag to display it in JSON format instead\.
 
 ```
 cdk synth --json MyStack
 ```
 
-### Specify the output directory<a name="w94aac69c33c15"></a>
+### Specify the output directory<a name="w94aac73c33c15"></a>
 
 Add the `--output` \(`-o`\) option to write the synthesized templates to a directory other than `cdk.out`\.
 
@@ -392,7 +392,7 @@ Git\-style wildcards, both `*` and `**`, can be used in the `"watch"` and `"buil
 **Important**  
 Watch mode is not recommended for production deployments\.
 
-### Specify AWS CloudFormation parameters<a name="w94aac69c35c19"></a>
+### Specify AWS CloudFormation parameters<a name="w94aac73c35c19"></a>
 
 The CDK CLI supports specifying AWS CloudFormation [parameters](parameters.md) at deployment\. You may provide these on the command line following the `--parameters` flag\.
 
@@ -414,7 +414,7 @@ cdk deploy MyStack YourStack --parameters MyStack:uploadBucketName=UploadBucket
 
 By default, the AWS CDK retains values of parameters from previous deployments and uses them in later deployments if they are not specified explicitly\. Use the `--no-previous-parameters` flag to require all parameters to be specified\.
 
-### Specify outputs file<a name="w94aac69c35c21"></a>
+### Specify outputs file<a name="w94aac73c35c21"></a>
 
 If your stack declares AWS CloudFormation outputs, these are normally displayed on the screen at the conclusion of deployment\. To write them to a file in JSON format, use the `--outputs-file` flag\.
 

v2/index.md

@@ -74,6 +74,7 @@ sponsored by Amazon.
    + [AWS CDK policy validation at synthesis time](policy-validation-synthesis.md)
    + [Continuous integration and delivery (CI/CD) using CDK Pipelines](cdk_pipeline.md)
    + [Troubleshoot AWS CDK deployments](deploy-troubleshoot.md)
++ [Perform programmatic actions using the CDK Toolkit Library](toolkit-library.md)
 + [Test AWS CDK applications](testing.md)
    + [Locally test and build AWS CDK applications with the AWS SAM CLI](testing-locally.md)
       + [Getting started with locally testing](testing-locally-getting-started.md)

v2/serverless_example.md

@@ -1494,7 +1494,7 @@ CdkHelloWorldStack: destroying... [1/1]
 
 ## Troubleshooting<a name="serverless-example-troubleshooting"></a>
 
-### Error: \{“message”: “Internal server error”\}%<a name="w94aac81c11c55b5"></a>
+### Error: \{“message”: “Internal server error”\}%<a name="w94aac85c11c55b5"></a>
 
 When invoking the deployed Lambda function, you receive this error\. This error could occur for multiple reasons\.
 

v2/toolkit-library.md

@@ -0,0 +1,28 @@
+# Perform programmatic actions using the CDK Toolkit Library<a name="toolkit-library"></a>
+
+**Note**  
+CDK Toolkit Library is in developer preview and is subject to change\.
+
+## What is the CDK Toolkit Library Library?<a name="toolkit-library-intro"></a>
+
+The AWS Cloud Development Kit \(AWS CDK\) Toolkit Library enables you to perform AWS CDK actions requiring programmatic access on AWS\. You can use the CDK Toolkit Library to implement actions such as bootstrapping, synthesizing, and deploying through code rather than CDK CLI commands\. With this library, you can create custom tools, build specialized CLI applications, and integrate CDK programmatic access capabilities into your development workflows\.
+
+The following is an example, that installs the CDK Toolkit Library and uses it to deploy a cloud assembly of your CDK app:
+
+```
+import { Toolkit } from '@aws-cdk/toolkit-lib'; // Install the CDK Toolkit Library
+
+const cdk = new Toolkit(); // Create a CDK Toolkit instance
+
+// ...
+
+// Implement a deployment
+await cdk.deploy(cloudAssembly, { 
+   deploymentMethod: { method: "direct" }, // Configure deployment options
+   ...
+}
+```
+
+## Get started with the CDK Toolkit Library<a name="toolkit-library-gs"></a>
+
+To get started, see the `[ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib)` in the *@aws\-cdk/toolkit\-lib* `npm` package\.