Upgrade guide

The Workflow Description Language has a number of versions that are constantly improving. This guide lists all major versions of the language—the major improvements for each version, common pitfalls when upgrading, and how to get help.

If you're interested in learning more about how versioning works and how you can specify the version of your WDL documents, see the Versioning section within the Language Guide.

Tip

Changes are grouped in terms of their impact. The word "impact" here is a combination of "how important is the change" along with "how many existing WDL documents are likely to be affected by this change". They are subjective determinations made by the upgrade guide curator during the curator process, but they are often helpful in quickly scanning upgrade elements to see which might apply to your situation.

Prior WDL versions

Versions of WDL prior to the ones outlined in this guide did not exist at the time the upgrade guide was created. As such, they are not included in the guide.