See Releases for information about AWS CDK releases. The AWS CDK is updated approximately once a week. Maintenance versions may be released between weekly releases to address critical issues. Each release includes a matched AWS CDK Toolkit (CDK CLI), AWS Construct Library, and API Reference. Updates to this Guide generally do not synchronize with AWS CDK releases.
Note
The table below represents significant documentation milestones. We fix errors and improve content on an ongoing basis.
| Change | Description | Date |
|---|---|---|
Document cdk.json |
Add documentation of cdk.json configuration values. |
April 20, 2022 |
| Dependency management | Add topic on managing dependencies with the AWS CDK. | April 7, 2022 |
| Remove double-braces from Java examples | Replace this anti-pattern with Java 9 Map.of throughout. |
March 9, 2022 |
| AWS CDK v2 release | Improvements to CDK v1 Developer Guide to coincide with the release of CDK v2 and its documentation. | December 4, 2021 |
cdk watch |
Add description of cdk watch command for incremental deployments. |
November 19, 2021 |
Testing with assertions |
Revise testing topic to use new assertions library. |
November 17, 2021 |
| Experimental modules | Explain how experimental modules work with CDK v2. | October 28, 2021 |
| Faster local development | Add information on --no-rollback and --hotswap options for accelerated local development. |
October 7, 2021 |
| Add local tooling information | Update TypeScript and JavaScript topics with information on using locally-installed tools (cdk, tsc). |
September 28, 2021 |
| Update CDK Pipelines API | Update CDK Pipelines topic to use new API. | August 24, 2021 |
| CloudFormation Public Registry | Add topic about using resource definitions from the CloudFormation Public Registry with the AWS CDK. | June 24, 2021 |
| Best Practices topic | Add topic about best practices for developing CDK apps. | June 10, 2021 |
| Go developer preview | Add information about Go language support (in developer preview) including a "Working with the CDK in Go" topic. | April 19, 2021 |
| Import or migrate AWS CloudFormation template | Add description of the new cloudformation-include.CfnInclude class, a powerful way to import and migrate AWS CloudFormation templates, or to vend them as AWS CDK constructs. |
October 15, 2020 |
| Add construct tree section | Information about the construct tree and its relation to the constructs you define in your AWS CDK app. | October 5, 2020 |
| Add Bootstrapping topic | A complete explanation of why and how to bootstrap AWS environments for the CDK, including a comprehensive discussion of how to customize the process. | September 8, 2020 |
| Add CDK Pipelines how-to | CDK Pipelines let you easily automate the deployment of your AWS CDK apps from source control whenever they're updated. | July 17, 2020 |
| Improve CDK Toolkit topic | Include more information and examples around performing common tasks with the CLI (and the relevant flags) rather than just including a copy of the help. | July 9, 2020 |
| Improve CodePipeline example | Update pipeline stack to build in proper language and add more material dealing with the CodeCommit repository. | July 6, 2020 |
| Improve Getting Started | Remove extraneous material from Getting Started, use a more conversational tone, incorporate current best practices. Break out Hello World into its own topic. | June 17, 2020 |
| Update stability index | Incorporate the latest definitions of the stability levels for AWS Construct Library modules. | June 11, 2020 |
| CDK Toolkit versioning | Add information about cloud assembly versioning and compatibility of the CDK Toolkit (CLI) with the AWS Construct Library | April 22, 2020 |
| Translating from TypeScript | Updated "CDK in Other Languages" topic to also include JavaScript, Java, and C# and renamed it "Translating from TypeScript." | April 10, 2020 |
| Parameters topic | Add Concepts topic on using parameters with the AWS CDK. | April 8, 2020 |
| JavaScript code snippets | Reinstate JavaScript code snippets throughout (automated translation via Babel). | April 3, 2020 |
| Working with the CDK | Add "Working with the CDK" articles for the five supported languages. Various other improvements and fixes. | February 4, 2020 |
| Java code snippets | Add Java code snippets throughout. Designate Java and C# bindings stable. | November 25, 2019 |
| C# code snippets | Add C# code snippets throughout. | November 19, 2019 |
| Python code snippets | Add Python code snippets throughout. Add Troubleshooting and Testing topics. | November 14, 2019 |
| Troubleshooting topic | Add Troubleshooting topic to AWS CDK Developer Guide. | October 30, 2019 |
| Improve Environments topic | Add Troubleshooting topic to AWS CDK Developer Guide. | October 10, 2019 |
| ECS Patterns improvements | Updates to reflect improvements to ECS Patterns module. | September 17, 2019 |
| New tagging API | Update tagging topic to use new API. | August 13, 2019 |
| General availability | The AWS CDK Developer Guide is released. | July 11, 2019 |