add experimental note

Author: austinvalle

ephemeral/doc.go

@@ -20,4 +20,7 @@
 // that has its own configuration and lifecycle logic. The [ephemeral.EphemeralResource]
 // implementations are referenced by the [provider.ProviderWithEphemeralResources] type
 // EphemeralResources method, which enables the ephemeral resource practitioner usage.
+//
+// NOTE: Ephemeral resource support is experimental and exposed without compatibility promises until
+// these notices are removed.
 package ephemeral

ephemeral/ephemeral_resource.go

@@ -23,6 +23,9 @@ import (
 //     HashiCorp Vault leases, which can be renewed without changing their data.
 //
 //   - Close: Allows providers to clean up the ephemeral resource via EphemeralResourceWithClose.
+//
+// NOTE: Ephemeral resource support is experimental and exposed without compatibility promises until
+// these notices are removed.
 type EphemeralResource interface {
 	// Metadata should return the full name of the ephemeral resource, such as
 	// examplecloud_thing.

ephemeral/schema/doc.go

@@ -5,4 +5,7 @@
 // Ephemeral resource schemas define the structure and value types for configuration
 // and result data. Schemas are implemented via the ephemeral.EphemeralResource type
 // Schema method.
+//
+// NOTE: Ephemeral resource support is experimental and exposed without compatibility promises until
+// these notices are removed.
 package schema

provider/provider.go

@@ -90,6 +90,9 @@ type ProviderWithFunctions interface {
 // include ephemeral resources for usage in practitioner configurations.
 //
 // Ephemeral resources are supported in Terraform version 1.10 and later.
+//
+// NOTE: Ephemeral resource support is experimental and exposed without compatibility promises until
+// these notices are removed.
 type ProviderWithEphemeralResources interface {
 	Provider