hashicorp / terraform-plugin-framework

A next-generation framework for building Terraform providers.
https://developer.hashicorp.com/terraform/plugin/framework
Mozilla Public License 2.0
305 stars 93 forks source link

docs: Fix package doc repeated copyright header #1054

Closed austinvalle closed 3 weeks ago

austinvalle commented 3 weeks ago

Nice little bug found in our copyright headers for the new ephemeral package docs.

The repeated lines are showing up because there is a missing newline in a number of the packages, causing the header to be repeated multiple time when running go docs ephemeral

Prior to the change: https://pkg.go.dev/github.com/hashicorp/terraform-plugin-framework@v1.13.0/ephemeral

After the change:

 $ go doc ephemeral      
package ephemeral // import "github.com/hashicorp/terraform-plugin-framework/ephemeral"

Package ephemeral contains all interfaces, request types, and response types for
an ephemeral resource implementation.

In Terraform, an ephemeral resource is a concept which enables provider
developers to offer practitioners ephemeral values, which will not be stored
in any artifact produced by Terraform (plan/state). Ephemeral resources can
optionally implement renewal logic via the (EphemeralResource).Renew method and
cleanup logic via the (EphemeralResource).Close method.

Ephemeral resources are not saved into the Terraform plan or state and can
only be referenced in other ephemeral values, such as provider configuration
attributes. Ephemeral resources are defined by a type/name, such as
"examplecloud_thing", a schema representing the structure and data types of
configuration, and lifecycle logic.

The main starting point for implementations in this package is the
EphemeralResource type which represents an instance of an ephemeral
resource 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.

type CloseRequest struct{ ... }
type CloseResponse struct{ ... }
type ConfigValidator interface{ ... }
type ConfigureRequest struct{ ... }
type ConfigureResponse struct{ ... }
type Deferred struct{ ... }
type DeferredReason int32
    const DeferredReasonUnknown DeferredReason = 0 ...
type EphemeralResource interface{ ... }
type EphemeralResourceWithClose interface{ ... }
type EphemeralResourceWithConfigValidators interface{ ... }
type EphemeralResourceWithConfigure interface{ ... }
type EphemeralResourceWithRenew interface{ ... }
type EphemeralResourceWithValidateConfig interface{ ... }
type MetadataRequest struct{ ... }
type MetadataResponse struct{ ... }
type OpenClientCapabilities struct{ ... }
type OpenRequest struct{ ... }
type OpenResponse struct{ ... }
type RenewRequest struct{ ... }
type RenewResponse struct{ ... }
type SchemaRequest struct{}
type SchemaResponse struct{ ... }
type ValidateConfigRequest struct{ ... }
type ValidateConfigResponse struct{ ... }