Add a deprecation message for grafana_builtin_role_assignment (#497)

* Add a deprecation message for grafana_builtin_role_assignment

* Compile docs

* Add a link to the grafana_role resource

Author: vtorosyan

docs/resources/builtin_role_assignment.md

@@ -3,12 +3,14 @@
 page_title: "grafana_builtin_role_assignment Resource - terraform-provider-grafana"
 subcategory: ""
 description: |-
+  Note: This resource is going to be deprecated with Grafana 9.+, please use grafana_role https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/role instead.
   Note: This resource is available only with Grafana Enterprise 8.+.
   Official documentation https://grafana.com/docs/grafana/latest/enterprise/access-control/HTTP API https://grafana.com/docs/grafana/latest/http_api/access_control/
 ---
 
 # grafana_builtin_role_assignment (Resource)
 
+**Note:** This resource is going to be deprecated with Grafana 9.+, please use [grafana_role](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/role) instead.
 **Note:** This resource is available only with Grafana Enterprise 8.+.
 
 * [Official documentation](https://grafana.com/docs/grafana/latest/enterprise/access-control/)

grafana/resource_builtin_role_assignment.go

@@ -15,6 +15,7 @@ import (
 func ResourceBuiltInRoleAssignment() *schema.Resource {
 	return &schema.Resource{
 		Description: `
+**Note:** This resource is going to be deprecated with Grafana 9.+, please use [grafana_role](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/role) instead.
 **Note:** This resource is available only with Grafana Enterprise 8.+.
 
 * [Official documentation](https://grafana.com/docs/grafana/latest/enterprise/access-control/)
@@ -27,6 +28,7 @@ func ResourceBuiltInRoleAssignment() *schema.Resource {
 		Importer: &schema.ResourceImporter{
 			StateContext: schema.ImportStatePassthroughContext,
 		},
+		DeprecationMessage: "This resource is going to be deprecated with Grafana 9.+, please use [grafana_role](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/role) instead",
 		Schema: map[string]*schema.Schema{
 			// Built-in roles are all organization roles and Grafana Admin
 			"builtin_role": {