Sync open source content 🐝 (from a8cb711d0eef786d52cc8a9f566103a8b61d29ae)

Author: beezythebot

docs/speakeasy-reference/workflow-file.mdx

@@ -27,12 +27,27 @@ A Target is a SDK, Terraform or other generated artifact from sources.
 
 ## Speakeasy Version
 
-The version of the Speakeasy CLI to use to run the workflow. The version can be a specific version or `latest` to use the latest version.
-Pinning to a specific version can be useful to ensure that the workflow runs consistently across different environments.
+The version of the Speakeasy CLI to use to run the workflow. The `speakeasyVersion` field accepts three types of values:
+
+- **`latest`**: The Speakeasy CLI will perform a blue/green attempted upgrade to the latest version of the CLI. If there is a failure in generation, it will always re-run on the last successful version. This is the default and always tries to bring in generator upgrades (for example, to dependencies) where those changes compile, lint successfully, and pass tests successfully.
+
+- **`pinned`**: The Speakeasy CLI will always execute on the installed version and won't attempt to change versions. This can be useful for teams with alternative automation to control the Speakeasy CLI version (for example, using [mise](https://mise.jdx.dev/)).
+
+- **A specific version** (for example, `1.493.1`): The Speakeasy CLI will always run on this exact version. This can be useful for teams with stringent change management procedures. Available versions correspond to [Speakeasy CLI releases](https://github.com/speakeasy-api/speakeasy/releases).
+
+```yaml
+workflowVersion: 1.0.0
+speakeasyVersion: latest
+```
+
+```yaml
+workflowVersion: 1.0.0
+speakeasyVersion: pinned
+```
 
 ```yaml
 workflowVersion: 1.0.0
-speakeasyVersion: v1.250.0
+speakeasyVersion: 1.493.1
 ```
 
 ## Sources