diff --git a/docs/guides/update-deprecated-resources.md b/docs/guides/update-deprecated-resources.md
index 903105dd7..262ef8d4c 100644
--- a/docs/guides/update-deprecated-resources.md
+++ b/docs/guides/update-deprecated-resources.md
@@ -217,8 +217,7 @@ Teams have been deprecated and are being migrated to groups. Groups are an easie
 
   The Account Owners and super admin are synced, so the removal of the
   Account Owners team will have no impact on existing permissions.
-  [Super admin](/docs/platform/concepts/orgs-units-projects#users-and-roles)
-  have full access to organizations.
+  Super admin have full access to organizations.
 
 * **From November 4, 2024 you won't be able to create new teams or update existing ones.**
 
diff --git a/docs/resources/organization_permission.md b/docs/resources/organization_permission.md
index c70f2dca7..455d5f4af 100644
--- a/docs/resources/organization_permission.md
+++ b/docs/resources/organization_permission.md
@@ -3,12 +3,12 @@
 page_title: "aiven_organization_permission Resource - terraform-provider-aiven"
 subcategory: ""
 description: |-
-  Grants permissions to a principal for a resource.
+  Grants permissions https://aiven.io/docs/platform/concepts/permissions to a principal for a resource.
 ---
 
 # aiven_organization_permission (Resource)
 
-Grants permissions to a principal for a resource.
+Grants [permissions](https://aiven.io/docs/platform/concepts/permissions) to a principal for a resource.
 
 ## Example Usage
 
diff --git a/internal/sdkprovider/service/organization/organization_permission.go b/internal/sdkprovider/service/organization/organization_permission.go
index b11a42b66..482c98d43 100644
--- a/internal/sdkprovider/service/organization/organization_permission.go
+++ b/internal/sdkprovider/service/organization/organization_permission.go
@@ -70,7 +70,7 @@ var permissionFields = map[string]*schema.Schema{
 
 func ResourceOrganizationalPermission() *schema.Resource {
 	return &schema.Resource{
-		Description:   "Grants permissions to a principal for a resource.",
+		Description:   "Grants [permissions](https://aiven.io/docs/platform/concepts/permissions) to a principal for a resource.",
 		CreateContext: common.WithGenClient(resourceOrganizationalPermissionUpsert),
 		ReadContext:   common.WithGenClient(resourceOrganizationalPermissionRead),
 		UpdateContext: common.WithGenClient(resourceOrganizationalPermissionUpsert),
diff --git a/templates/guides/update-deprecated-resources.md b/templates/guides/update-deprecated-resources.md
index 903105dd7..262ef8d4c 100644
--- a/templates/guides/update-deprecated-resources.md
+++ b/templates/guides/update-deprecated-resources.md
@@ -217,8 +217,7 @@ Teams have been deprecated and are being migrated to groups. Groups are an easie
 
   The Account Owners and super admin are synced, so the removal of the
   Account Owners team will have no impact on existing permissions.
-  [Super admin](/docs/platform/concepts/orgs-units-projects#users-and-roles)
-  have full access to organizations.
+  Super admin have full access to organizations.
 
 * **From November 4, 2024 you won't be able to create new teams or update existing ones.**