Remove experimental warnings for worker versioning and envconfig (#1315)

* Remove experimental warnings for worker versioning and envconfig, for GA (also a lingering warning for UwS)

* mark old worker versioning client-side APIs as deprecated

* more experimental notice removals (forgot to save file)

* add deprecation arguments

* formatting

Author: THardy98

temporalio/client.py

@@ -1094,9 +1094,6 @@ async def start_update_with_start_workflow(
         means that the call will not return successfully until the update has been
         delivered to a worker.
 
-        .. warning::
-           This API is experimental
-
         Args:
             update: Update function or name on the workflow. arg: Single argument to the
                 update.
@@ -1431,8 +1428,8 @@ async def update_worker_build_id_compatibility(
 
         For more on this feature, see https://docs.temporal.io/workers#worker-versioning
 
-        .. warning::
-           This API is experimental
+        .. deprecated::
+            Legacy API, see the docs above for new usage
 
         Args:
             task_queue: The task queue to target.
@@ -1461,8 +1458,8 @@ async def get_worker_build_id_compatibility(
 
         For more on this feature, see https://docs.temporal.io/workers#worker-versioning
 
-        .. warning::
-           This API is experimental
+        .. deprecated::
+            Legacy API, see the docs above for new usage
 
         Args:
             task_queue: The task queue to target.
@@ -1493,8 +1490,8 @@ async def get_worker_task_reachability(
 
         For more on this feature, see https://docs.temporal.io/workers#worker-versioning
 
-        .. warning::
-           This API is experimental
+        .. deprecated::
+            Legacy API, see the docs above for new usage
 
         Args:
             build_ids: The Build IDs to query the reachability of. At least one must be specified.

temporalio/common.py

@@ -1040,10 +1040,7 @@ def __post_init__(self):
 
 
 class VersioningBehavior(IntEnum):
-    """Specifies when a workflow might move from a worker of one Build Id to another.
-
-    WARNING: Experimental API.
-    """
+    """Specifies when a workflow might move from a worker of one Build Id to another."""
 
     UNSPECIFIED = (
         temporalio.api.enums.v1.VersioningBehavior.VERSIONING_BEHAVIOR_UNSPECIFIED
@@ -1061,10 +1058,7 @@ class VersioningBehavior(IntEnum):
 
 @dataclass(frozen=True)
 class WorkerDeploymentVersion:
-    """Represents the version of a specific worker deployment.
-
-    WARNING: Experimental API.
-    """
+    """Represents the version of a specific worker deployment."""
 
     deployment_name: str
     build_id: str
@@ -1094,11 +1088,7 @@ def _to_proto(self) -> temporalio.api.deployment.v1.WorkerDeploymentVersion:
 
 
 class VersioningOverride(ABC):
-    """Represents the override of a worker's versioning behavior for a workflow execution.
-
-    .. warning::
-        Experimental API.
-    """
+    """Represents the override of a worker's versioning behavior for a workflow execution."""
 
     @abstractmethod
     def _to_proto(self) -> temporalio.api.workflow.v1.VersioningOverride:
@@ -1108,11 +1098,7 @@ def _to_proto(self) -> temporalio.api.workflow.v1.VersioningOverride:
 
 @dataclass(frozen=True)
 class PinnedVersioningOverride(VersioningOverride):
-    """Workflow will be pinned to a specific deployment version.
-
-    .. warning::
-        Experimental API.
-    """
+    """Workflow will be pinned to a specific deployment version."""
 
     version: WorkerDeploymentVersion
 
@@ -1131,11 +1117,7 @@ def _to_proto(self) -> temporalio.api.workflow.v1.VersioningOverride:
 
 @dataclass(frozen=True)
 class AutoUpgradeVersioningOverride(VersioningOverride):
-    """The workflow will auto-upgrade to the current deployment version on the next workflow task.
-
-    .. warning::
-        Experimental API.
-    """
+    """The workflow will auto-upgrade to the current deployment version on the next workflow task."""
 
     def _to_proto(self) -> temporalio.api.workflow.v1.VersioningOverride:
         """Convert to proto representation."""

temporalio/envconfig.py

@@ -100,11 +100,7 @@ def _read_source(source: DataSource | None) -> bytes | None:
 
 @dataclass(frozen=True)
 class ClientConfigTLS:
-    """TLS configuration as specified as part of client configuration
-
-    .. warning::
-        Experimental API.
-    """
+    """TLS configuration as specified as part of client configuration"""
 
     disabled: bool | None = None
     """If True, TLS is explicitly disabled. If False, TLS is explicitly enabled. If None, TLS behavior was not configured."""
@@ -168,9 +164,6 @@ def from_dict(cls, d: ClientConfigTLSDict | None) -> Self | None:
 class ClientConnectConfig(TypedDict, total=False):
     """Arguments for `temporalio.client.Client.connect` that are configurable via
     environment configuration.
-
-    .. warning::
-        Experimental API.
     """
 
     target_host: str
@@ -187,9 +180,6 @@ class ClientConfigProfile:
     This class holds the configuration as loaded from a file or environment.
     See `to_client_connect_config` to transform the profile to `ClientConnectConfig`,
     which can be used to create a client.
-
-    .. warning::
-        Experimental API.
     """
 
     address: str | None = None
@@ -307,9 +297,6 @@ class ClientConfig:
     This contains a mapping of profile names to client profiles. Use
     `ClientConfigProfile.to_client_connect_config` to create a `ClientConnectConfig`
     from a profile. See `ClientConfigProfile.load` to load an individual profile.
-
-    .. warning::
-        Experimental API.
     """
 
     profiles: Mapping[str, ClientConfigProfile]

temporalio/worker/_worker.py

@@ -957,10 +957,7 @@ def _warn_if_nexus_task_executor_max_workers_is_inconsistent(
 
 @dataclass
 class WorkerDeploymentConfig:
-    """Options for configuring the Worker Versioning feature.
-
-    WARNING: This is an experimental feature and may change in the future.
-    """
+    """Options for configuring the Worker Versioning feature."""
 
     version: WorkerDeploymentVersion
     use_worker_versioning: bool

temporalio/workflow.py

@@ -139,7 +139,6 @@ def defn(
             ``Exception`` is set, it effectively will fail a workflow/update in
             all user exception cases. WARNING: This setting is experimental.
         versioning_behavior: Specifies the versioning behavior to use for this workflow.
-            WARNING: This setting is experimental.
     """
 
     def decorator(cls: ClassType) -> ClassType:
@@ -444,8 +443,6 @@ class DynamicWorkflowConfig:
     """Specifies the versioning behavior to use for this workflow.
 
     Always overrides the equivalent parameter on :py:func:`defn`.
-
-        WARNING: This setting is experimental.
     """