bring docs over from other PR

Author: austinvalle

action/doc.go

@@ -1,5 +1,15 @@
 // Copyright (c) HashiCorp, Inc.
 // SPDX-License-Identifier: MPL-2.0
 
-// TODO:Actions: Eventual package docs for actions
+// Package action contains all interfaces, request types, and response
+// types for an action implementation.
+//
+// In Terraform, an action is a concept which enables provider developers
+// to offer practitioners ad-hoc side-effects to be used in their configuration.
+//
+// The main starting point for implementations in this package is the
+// [Action] type which represents an instance of an action that has its
+// own configuration, plan, and invoke logic. The [Action] implementations
+// are referenced by the [provider.ProviderWithActions] type Actions method,
+// which enables the action practitioner usage.
 package action

action/invoke.go

@@ -29,9 +29,7 @@ type InvokeResponse struct {
 	Diagnostics diag.Diagnostics
 
 	// SendProgress will immediately send a progress update to Terraform core during action invocation.
-	// This function is provided by the framework and can be called multiple times while action logic is running.
-	//
-	// TODO:Actions: More documentation about when you should use this / when you shouldn't
+	// This function is pre-populated by the framework and can be called multiple times while action logic is running.
 	SendProgress func(event InvokeProgressEvent)
 
 	// TODO:Actions: Add linked resources once lifecycle/linked actions are implemented

provider/provider.go

@@ -138,7 +138,7 @@ type ProviderWithListResources interface {
 // ProviderWithActions is an interface type that extends Provider to
 // include actions for usage in practitioner configurations.
 //
-// TODO:Actions: State which Terraform version will support actions
+// Actions are supported in Terraform version 1.14 and later.
 type ProviderWithActions interface {
 	Provider