Sync open source content 🐝 (from 79f36794350fa4e9add8ddf99ac7b065003198d5)

Author: beezythebot

docs/customize-testing/customizing-sdk-tests.mdx

@@ -3,16 +3,9 @@ title: "Customizing SDK Tests"
 description: "Learn how to customize SDK tests after they are boostrapped."
 ---
 
-# Customizing SDK Tests
-
-## Regenerate tests from scratch
-
-By default tests will only be populated from modifications to the `tests.arazzo.yaml` file after bootstrapping.
-To regenerate all SDK tests from scratch, run the following command:
+import { Callout } from "@/mdx/components";
 
-```bash
-speakeasy configure tests --rebuild
-```
+# Customizing SDK Tests
 
 
 ## Disable auto generation of tests for specific operations
@@ -81,3 +74,26 @@ To learn more about these kinds of modifications see [here](/docs/api-contract-t
 ## Next Steps
 
 - [Setup testing in GitHub Actions](/docs/customize-testing/github-actions)
+
+<Callout title="Bootstrapping tests again from scratch" type="info">
+Once the original `tests.arazzo.yaml` document is bootstrapped, the Arazzo document will only be modified automatically when new operations are detected and `generateNewTests: true` is set in your `./speakeasy/gen.yaml`, new tests will be bootstrapped for these new operations. But pre-bootstrapped tests will be left alone.
+
+If you want to bootstrap all workflows in the Arazzo document from scratch again (for example to match changes to operations or examples in your spec), run the following command:
+
+```bash
+speakeasy configure tests --rebuild
+```
+
+You can also selectively bootstrap individual tests by:
+1. Deleting the specific workflow from the arazzo doc in `.speakeasy/tests.arazzo.yaml`
+2. Removing the corresponding entry in `.speakeasy/gen.lock` under `generatedTests`
+
+For example, to bootstrap a test for the `createLink` operation again, delete its entry in the gen.lock file:
+
+```yaml
+generatedTests:
+  createLink: "2025-05-21T12:47:33+10:00" # Delete this to bootstrap test again from scratch
+```
+
+This approach preserves any other manual changes you've made to your arazzo doc.
+</Callout>