Merge branch 'main' into NEXUS-190

Author: jsundai

.github/workflows/snipsync.yml

@@ -0,0 +1,83 @@
+name: Snipsync
+
+on:
+  schedule:
+    - cron: '0 6 * * *' # Daily at 6:00 UTC
+  workflow_dispatch:
+
+jobs:
+  snipsync:
+    name: Sync code snippets
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Generate token
+        id: generate_token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.TEMPORAL_CICD_APP_ID }}
+          private-key: ${{ secrets.TEMPORAL_CICD_PRIVATE_KEY }}
+
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          token: ${{ steps.generate_token.outputs.token }}
+          ref: main
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Run snipsync
+        run: yarn snipsync
+
+      - name: Check for changes
+        id: changes
+        run: |
+          if git diff --quiet; then
+            echo "has_changes=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "has_changes=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Commit and push changes
+        if: steps.changes.outputs.has_changes == 'true'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          branch_name="snipsync/daily-update"
+          git checkout -B "$branch_name"
+          git add docs/
+          git commit -m "chore: sync code snippets via snipsync"
+          git push --force-with-lease origin "$branch_name"
+
+      - name: Create or update PR
+        if: steps.changes.outputs.has_changes == 'true'
+        env:
+          GH_TOKEN: ${{ steps.generate_token.outputs.token }}
+        run: |
+          branch_name="snipsync/daily-update"
+          existing_pr=$(gh pr list --head "$branch_name" --state open --json number --jq '.[0].number')
+
+          if [ -n "$existing_pr" ]; then
+            echo "PR #$existing_pr already exists — updated with latest push."
+          else
+            gh pr create \
+              --title "chore: sync code snippets" \
+              --body "$(cat <<'EOF'
+          Automated daily sync of code snippets from source repositories via snipsync.
+
+          This PR was generated by the [Snipsync workflow](https://github.com/${{ github.repository }}/actions/workflows/snipsync.yml).
+          EOF
+              )" \
+              --head "$branch_name" \
+              --base "main"
+          fi

docs/develop/go/cancellation.mdx

@@ -52,7 +52,7 @@ func YourWorkflow(ctx workflow.Context) error {
 		WaitForCancellation: true,
 	}
 	defer func() {
-		// This logic ensures cleanup only happens if there is a Cancellation error
+		// This logic ensures cleanup only happens if there is a Cancelation error
 		if !errors.Is(ctx.Err(), workflow.ErrCanceled) {
 			return
 		}

docs/develop/go/temporal-nexus.mdx

@@ -336,6 +336,45 @@ func HelloCallerWorkflow(ctx workflow.Context, name string, language service.Lan
 ```
 <!--SNIPEND-->
 
+### Set Nexus Operation timeouts
+
+Nexus Operations support [three types of timeouts](/nexus/operations#timeouts) that control how long the caller is willing to wait at different stages of the Operation lifecycle.
+Set these timeouts in `NexusOperationOptions` when calling `ExecuteOperation`.
+
+#### Schedule-to-Close timeout
+
+The [Schedule-to-Close timeout](/nexus/operations#schedule-to-close-timeout) limits the total duration of the Operation from when it is scheduled to when it completes.
+The Nexus Machinery automatically retries failed requests until this timeout is exceeded.
+
+```go
+fut := c.ExecuteOperation(ctx, service.HelloOperationName, service.HelloInput{Name: name, Language: language}, workflow.NexusOperationOptions{
+	ScheduleToCloseTimeout: 10 * time.Minute,
+})
+```
+
+#### Schedule-to-Start timeout
+
+The [Schedule-to-Start timeout](/nexus/operations#schedule-to-start-timeout) limits how long the caller will wait for the Operation to be started by the handler.
+If not set, no Schedule-to-Start timeout is enforced.
+
+```go
+fut := c.ExecuteOperation(ctx, service.HelloOperationName, service.HelloInput{Name: name, Language: language}, workflow.NexusOperationOptions{
+	ScheduleToStartTimeout: 2 * time.Minute,
+})
+```
+
+#### Start-to-Close timeout
+
+The [Start-to-Close timeout](/nexus/operations#start-to-close-timeout) limits how long the caller will wait for an asynchronous Operation to complete after it has been started.
+This timeout only applies to asynchronous Operations.
+If not set, no Start-to-Close timeout is enforced.
+
+```go
+fut := c.ExecuteOperation(ctx, service.HelloOperationName, service.HelloInput{Name: name, Language: language}, workflow.NexusOperationOptions{
+	StartToCloseTimeout: 5 * time.Minute,
+})
+```
+
 ### Register the caller Workflow in a Worker
 
 After developing the caller Workflow, the next step is to register it with a Worker.