Docstrings, comments

Author: dandavison

temporalio/client.py

@@ -5203,6 +5203,7 @@ class StartWorkflowInput:
     rpc_timeout: Optional[timedelta]
     request_eager_start: bool
     priority: temporalio.common.Priority
+    # The following options are experimental and unstable.
     nexus_completion_callbacks: Sequence[NexusCompletionCallback]
     workflow_event_links: Sequence[temporalio.api.common.v1.Link.WorkflowEvent]
     request_id: Optional[str]
@@ -7264,7 +7265,11 @@ def api_key(self, value: Optional[str]) -> None:
 
 @dataclass(frozen=True)
 class NexusCompletionCallback:
-    """Nexus callback to attach to events such as workflow completion."""
+    """Nexus callback to attach to events such as workflow completion.
+
+    .. warning::
+        This option is experimental and unstable.
+    """
 
     url: str
     """Callback URL."""

temporalio/nexus/_decorators.py

@@ -115,7 +115,7 @@ async def _start(
             return WorkflowRunOperationHandler(_start, input_type, output_type)
 
         method_name = get_callable_name(start)
-        # TODO(preview): make double-underscore attrs private to nexusrpc and expose getters/setters
+        # TODO(nexus-preview): make double-underscore attrs private to nexusrpc and expose getters/setters
         operation_handler_factory.__nexus_operation__ = nexusrpc.Operation(
             name=name or method_name,
             method_name=method_name,