Add comments and documentation for WorkflowLockTimeout and ActivityLockTimeout options

- Add GoDoc comments for WithWorkflowLockTimeout and WithActivityLockTimeout functions
- Add both options to public documentation in _backends.md with default values
- Addresses review feedback on PR #403

Co-authored-by: cschleiden <[email protected]>

Author: Copilot

backend/options.go

@@ -124,12 +124,16 @@ func WithWorkerName(workerName string) BackendOption {
 	}
 }
 
+// WithWorkflowLockTimeout sets the timeout for workflow task locks. If a workflow task is not completed
+// within this timeframe, it's considered abandoned and another worker might pick it up.
 func WithWorkflowLockTimeout(timeout time.Duration) BackendOption {
 	return func(o *Options) {
 		o.WorkflowLockTimeout = timeout
 	}
 }
 
+// WithActivityLockTimeout sets the timeout for activity task locks. If an activity task is not completed
+// within this timeframe, it's considered abandoned and another worker might pick it up.
 func WithActivityLockTimeout(timeout time.Duration) BackendOption {
 	return func(o *Options) {
 		o.ActivityLockTimeout = timeout

docs/source/includes/_backends.md

@@ -3,6 +3,8 @@
 There are three backend implementations maintained in this repository. Some backend implementations have custom options and all of them accept:
 
 - `WithStickyTimeout(timeout time.Duration)` - Set the timeout for sticky tasks. Defaults to 30 seconds
+- `WithWorkflowLockTimeout(timeout time.Duration)` - Set the timeout for workflow task locks. Defaults to 1 minute
+- `WithActivityLockTimeout(timeout time.Duration)` - Set the timeout for activity task locks. Defaults to 2 minutes
 - `WithLogger(logger *slog.Logger)` - Set the logger implementation
 - `WithMetrics(client metrics.Client)` - Set the metrics client
 - `WithTracerProvider(tp trace.TracerProvider)` - Set the OpenTelemetry tracer provider