From 7b50139a6cd42348e204495ac398bfc1aeca17ca Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Wed, 23 Apr 2025 06:25:30 -0700
Subject: [PATCH] content: Miscellaneous edits

---
 content/en/installation/linux.md | 20 ++++++++++++++++++--
 content/en/shortcodes/ref.md     |  2 +-
 content/en/shortcodes/relref.md  |  5 +++--
 3 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/content/en/installation/linux.md b/content/en/installation/linux.md
index 731cfce4c..591bf0818 100644
--- a/content/en/installation/linux.md
+++ b/content/en/installation/linux.md
@@ -30,17 +30,33 @@ To install the extended edition of Hugo:
 sudo snap install hugo
 ```
 
-To enable or revoke access to removable media:
+To control automatic updates:
 
 ```sh
+# disable automatic updates
+sudo snap refresh --hold hugo
+
+# enable automatic updates
+sudo snap refresh --unhold hugo
+```
+
+To control access to removable media:
+
+```sh
+# allow access
 sudo snap connect hugo:removable-media
+
+# revoke access
 sudo snap disconnect hugo:removable-media
 ```
 
-To enable or revoke access to SSH keys:
+To control access to SSH keys:
 
 ```sh
+# allow access
 sudo snap connect hugo:ssh-keys
+
+# revoke access
 sudo snap disconnect hugo:ssh-keys
 ```
 
diff --git a/content/en/shortcodes/ref.md b/content/en/shortcodes/ref.md
index 2f821254c..50368dfe2 100755
--- a/content/en/shortcodes/ref.md
+++ b/content/en/shortcodes/ref.md
@@ -10,7 +10,7 @@ keywords: []
 > To override Hugo's embedded `ref` shortcode, copy the [source code] to a file with the same name in the `layouts/shortcodes` directory.
 
 > [!note]
-> When working with the Markdown [content format], this shortcode has become largely redundant. Its functionality is now primarily handled by [link render hooks], specifically the embedded one provided by Hugo. This hook effectively addresses all the use cases previously covered by this shortcode.
+> When working with Markdown, this shortcode is obsolete. Instead, use a [link render hook] that resolves the link destination using the `GetPage` method on the `Page` object. You can either create your own, or simply enable the [embedded link render hook]. The embedded link render hook is automatically enabled for multilingual single-host projects.
 
 ## Usage
 
diff --git a/content/en/shortcodes/relref.md b/content/en/shortcodes/relref.md
index 5b413b87e..4edc6281e 100755
--- a/content/en/shortcodes/relref.md
+++ b/content/en/shortcodes/relref.md
@@ -10,7 +10,7 @@ keywords: []
 > To override Hugo's embedded `relref` shortcode, copy the [source code] to a file with the same name in the `layouts/shortcodes` directory.
 
 > [!note]
-> When working with the Markdown [content format], this shortcode has become largely redundant. Its functionality is now primarily handled by [link render hooks], specifically the embedded one provided by Hugo. This hook effectively addresses all the use cases previously covered by this shortcode.
+> When working with Markdown, this shortcode is obsolete. Instead, use a [link render hook] that resolves the link destination using the `GetPage` method on the `Page` object. You can either create your own, or simply enable the [embedded link render hook]. The embedded link render hook is automatically enabled for multilingual single-host projects.
 
 ## Usage
 
@@ -56,6 +56,7 @@ Rendered:
 {{% include "_common/ref-and-relref-error-handling.md" %}}
 
 [content format]: /content-management/formats/
-[link render hooks]: /render-hooks/links/
+[link render hook]: /render-hooks/links/
 [Markdown notation]: /content-management/shortcodes/#notation
 [source code]: {{% eturl relref %}}
+[embedded link render hook]: /render-hooks/links/#default