From 69512baa8b80fe4e923292c1e9faaf40b98ca1de Mon Sep 17 00:00:00 2001
From: Dan Heath <76443935+Dan-Heath@users.noreply.github.com>
Date: Wed, 7 Feb 2024 15:19:00 -0500
Subject: [PATCH] docs: Add links for multi grant scopes (#4368)

* docs: Add links for multi grant scopes

* Update website/content/docs/commands/roles/create.mdx

Co-authored-by: Robin Beck <stellarsquall@users.noreply.github.com>

* docs: Add link to command docs

---------

Co-authored-by: Robin Beck <stellarsquall@users.noreply.github.com>
---
 website/content/docs/commands/roles/create.mdx | 2 ++
 website/content/docs/commands/roles/update.mdx | 2 ++
 website/content/docs/release-notes/v0_15_0.mdx | 8 ++++++--
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/website/content/docs/commands/roles/create.mdx b/website/content/docs/commands/roles/create.mdx
index f5e5b04094..4149b9f2a1 100644
--- a/website/content/docs/commands/roles/create.mdx
+++ b/website/content/docs/commands/roles/create.mdx
@@ -33,6 +33,8 @@ $ boundary roles create [options] [args]
 
 - `-description=<string>` - The description to assign to the role.
 - `-grant-scope-id=<string>` - The scope ID for any grants set on the role.
+The `grant-scope-id` field is now deprecated in favor of multiple grant scope support using [add-grant-scopes](/boundary/docs/commands/roles/add-grant-scopes).
+For more information, refer to [Version 0.15.0 feature deprecations and EOL](/boundary/docs/release-notes/v0_15_0#feature-deprecations-and-eol).
 - `-name=<string>` - The name to assign to the role.
 - `-scope-id=<string>` - The scope in which you want to create the role.
 The default is `global`.
diff --git a/website/content/docs/commands/roles/update.mdx b/website/content/docs/commands/roles/update.mdx
index 0a906be84a..0868dc1917 100644
--- a/website/content/docs/commands/roles/update.mdx
+++ b/website/content/docs/commands/roles/update.mdx
@@ -33,6 +33,8 @@ $ boundary roles update [options] [args]
 
 - `-description=<string>` - The description to set on the role.
 - `-grant-scope-id=<string>` - The scope ID for any grants set on the role.
+The `grant-scope-id` field is now deprecated in favor of multiple grant scope support using [add-grant-scopes](/boundary/docs/commands/roles/add-grant-scopes).
+For more information, refer to [Version 0.15.0 feature deprecations and EOL](/boundary/docs/release-notes/v0_15_0#feature-deprecations-and-eol).
 - `-id=<string>` - The ID of the role you want to update.
 - `-name=<string>` - The name to set on the role.
 - `-version=<int>` - The version of the role you want to update.
diff --git a/website/content/docs/release-notes/v0_15_0.mdx b/website/content/docs/release-notes/v0_15_0.mdx
index 748ef54cb0..9d16667bf8 100644
--- a/website/content/docs/release-notes/v0_15_0.mdx
+++ b/website/content/docs/release-notes/v0_15_0.mdx
@@ -83,6 +83,8 @@ description: |-
     </td>
     <td style={{verticalAlign: 'middle'}}>
       Roles now support multiple grant scopes, along with the special values <code>this</code>, <code>children</code> (global/org scopes only) to apply to all direct children of a scope, and <code>descendants</code> (global only) to apply to all descendants of a scope. You can apply the new values by using the commands <code>add-grant-scopes</code>, <code>set-grant-scopes</code>, and <code>remove-grant-scopes</code> on roles. You can continue to use the existing <code>grant_scope_id</code> field for now, but it has been deprecated.
+      <br /><br />
+      Learn more:&nbsp;<a href="/boundary/docs/commands/roles/add-grant-scopes"><code>add-grant-scopes</code></a>, <a href="/boundary/docs/commands/roles/remove-grant-scopes"><code>remove-grant-scopes</code></a>, and <a href="/boundary/docs/commands/roles/set-grant-scopes"><code>set-grant-scopes</code></a>
     </td>
   </tr>
 
@@ -229,10 +231,12 @@ description: |-
 
   <tr>
     <td style={{verticalAlign: 'middle'}}>
-      <code>grant_scope_id</code> field for roles
+      <code>grant-scope-id</code> field for roles
     </td>
     <td style={{verticalAlign: 'middle'}}>
-     The <code>grant_scope_id</code> field is now deprecated in favor of multiple grant scope support.
+     The <code>grant-scope-id</code> field is now deprecated in favor of multiple grant scope support.
+      <br /><br />
+      Learn more:&nbsp;<a href="/boundary/docs/commands/roles/add-grant-scopes"><code>add-grant-scopes</code></a>, <a href="/boundary/docs/commands/roles/remove-grant-scopes"><code>remove-grant-scopes</code></a>, and <a href="/boundary/docs/commands/roles/set-grant-scopes"><code>set-grant-scopes</code></a>
     </td>
   </tr>