doc: points to braket doc when using experimental caps (#1149)

Author: yitchen-tim

src/braket/experimental_capabilities/experimental_capability_context.py

@@ -14,6 +14,7 @@
 from __future__ import annotations
 
 import types
+import warnings
 
 
 class ExperimentalCapabilityContextError(Exception):
@@ -83,6 +84,18 @@ def __enter__(self) -> None:
         """
         GLOBAL_EXPERIMENTAL_CAPABILITY_CONTEXT.enable()
 
+        warnings.warn(
+            (
+                "You are enabling experimental capabilities. To view descriptions and "
+                "restrictions of experimental capabilities, please review Amazon Braket "
+                "Developer Guide ("
+                "https://docs.aws.amazon.com/braket/latest/developerguide/braket-experimental-capabilities.html"
+                ")."
+            ),
+            category=UserWarning,
+            stacklevel=1,
+        )
+
     def __exit__(
         self,
         exc_type: type[BaseException] | None,