ref: update docs

jianyuan · Dec 13, 2023 · be719af · be719af
1 parent d3d6e0d
commit be719af
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 13 deletions.
diff --git a/docs/data-sources/organization_integration.md b/docs/data-sources/organization_integration.md
@@ -3,12 +3,12 @@
 page_title: "sentry_organization_integration Data Source - terraform-provider-sentry"
 subcategory: ""
 description: |-
-  Sentry Organization Integration data source.
+  Sentry Organization Integration data source. See the Sentry documentation https://docs.sentry.io/api/integrations/list-an-organizations-available-integrations/ for more information.
 ---
 
 # sentry_organization_integration (Data Source)
 
-Sentry Organization Integration data source.
+Sentry Organization Integration data source. See the [Sentry documentation](https://docs.sentry.io/api/integrations/list-an-organizations-available-integrations/) for more information.
 
 ## Example Usage
 
@@ -35,13 +35,13 @@ data "sentry_organization_integration" "slack" {
 
 ### Required
 
-- `name` (String) The name of the organization integration.
-- `organization` (String) The slug of the organization the integration belongs to.
-- `provider_key` (String) The key of the organization integration provider.
+- `name` (String) The name of the integration.
+- `organization` (String) The slug of the organization.
+- `provider_key` (String) Specific integration provider to filter by such as `slack`. See [the list of supported providers](https://docs.sentry.io/product/integrations/).
 
 ### Read-Only
 
 - `id` (String) The ID of this resource.
-- `internal_id` (String) The internal ID for this organization integration.
+- `internal_id` (String, Deprecated) The internal ID for this organization integration. **Deprecated** Use `id` instead.
 
 
diff --git a/internal/provider/data_source_organization_integration.go b/internal/provider/data_source_organization_integration.go
@@ -48,17 +48,17 @@ func (d *OrganizationIntegrationDataSource) Schema(ctx context.Context, req data
 
 		Attributes: map[string]schema.Attribute{
 			"id": schema.StringAttribute{
-				MarkdownDescription: "The ID of this resource.",
-				Computed:            true,
+				Description: "The ID of this resource.",
+				Computed:    true,
 			},
 			"internal_id": schema.StringAttribute{
-				Description:        "The internal ID for this organization integration.",
-				Computed:           true,
-				DeprecationMessage: "This field is deprecated and will be removed in a future version. Use `id` instead.",
+				MarkdownDescription: "The internal ID for this organization integration. **Deprecated** Use `id` instead.",
+				Computed:            true,
+				DeprecationMessage:  "This field is deprecated and will be removed in a future version. Use `id` instead.",
 			},
 			"organization": schema.StringAttribute{
-				MarkdownDescription: "The slug of the organization.",
-				Required:            true,
+				Description: "The slug of the organization.",
+				Required:    true,
 			},
 			"provider_key": schema.StringAttribute{
 				Description: "Specific integration provider to filter by such as `slack`. See [the list of supported providers](https://docs.sentry.io/product/integrations/).",