From 3c5c048152b620ffdcb49f1cd7f55c4ec28ef358 Mon Sep 17 00:00:00 2001
From: hashicc <191911133+hashicc@users.noreply.github.com>
Date: Tue, 9 Sep 2025 13:49:11 -0700
Subject: [PATCH] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20update=20alias=20v?=
 =?UTF-8?q?alue=20helper=20text=20(#2995)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 addons/core/translations/resources/en-us.yaml | 2 +-
 ui/admin/app/components/form/alias/index.hbs  | 7 ++++++-
 ui/admin/config/environment.js                | 2 ++
 3 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/addons/core/translations/resources/en-us.yaml b/addons/core/translations/resources/en-us.yaml
index 9b76dd3d2..24698867f 100644
--- a/addons/core/translations/resources/en-us.yaml
+++ b/addons/core/translations/resources/en-us.yaml
@@ -1224,7 +1224,7 @@ alias:
       help: Specify any target across your deployment to associate this alias with
     value:
       label: Alias Value
-      help: The alias you would like to use for this resource
+      help: The alias you would like to use for this resource. If using Windows, using a "." in the hostname is recommended.
     authorize_session_arguments:
       label: Host ID
       help: Always use this host when connecting using this alias
diff --git a/ui/admin/app/components/form/alias/index.hbs b/ui/admin/app/components/form/alias/index.hbs
index 96e6db296..ad75d25d1 100644
--- a/ui/admin/app/components/form/alias/index.hbs
+++ b/ui/admin/app/components/form/alias/index.hbs
@@ -81,7 +81,12 @@
     as |F|
   >
     <F.Label>{{t 'resources.alias.form.value.label'}}</F.Label>
-    <F.HelperText>{{t 'resources.alias.form.value.help'}}</F.HelperText>
+    <F.HelperText>
+      {{t 'resources.alias.form.value.help'}}
+      <Hds::Link::Inline @href={{doc-url 'alias.single-word-aliases'}}>
+        {{t 'actions.learn-more'}}
+      </Hds::Link::Inline>
+    </F.HelperText>
     {{#if @model.errors.value}}
       <F.Error as |E|>
         {{#each @model.errors.value as |error|}}
diff --git a/ui/admin/config/environment.js b/ui/admin/config/environment.js
index 61ae72f4d..cb3a04d75 100644
--- a/ui/admin/config/environment.js
+++ b/ui/admin/config/environment.js
@@ -133,6 +133,8 @@ module.exports = function (environment) {
         'storage-policy.update':
           '/docs/configuration/session-recording/update-storage-policy',
         alias: '/docs/concepts/aliases',
+        'alias.single-word-aliases':
+          '/docs/targets/configuration#single-word-aliases-and-transparent-sessions',
         'support-page': 'https://support.hashicorp.com/hc/en-us',
       },
     },