From dc1c0aeeb1794ad2e64e66c5dddef4c69fa4cc0c Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Thu, 4 Jan 2024 11:19:04 -0800
Subject: [PATCH] Add cache note to resources.Concat

---
 content/en/functions/resources/Concat.md          | 15 ++++++++++-----
 .../en/functions/resources/ExecuteAsTemplate.md   | 10 ++++++++--
 content/en/functions/resources/FromString.md      | 10 ++++++++--
 3 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/content/en/functions/resources/Concat.md b/content/en/functions/resources/Concat.md
index 3bdf975bf..809ee83d0 100644
--- a/content/en/functions/resources/Concat.md
+++ b/content/en/functions/resources/Concat.md
@@ -1,6 +1,6 @@
 ---
 title: resources.Concat
-description: Concatenates a slice of resources.
+description: Returns a concatenated slice of resources.
 categories: []
 keywords: []
 action:
@@ -10,12 +10,17 @@ action:
   signatures: ['resources.Concat TARGETPATH [RESOURCE...]']
 ---
 
+The `resources.Concat` function returns a concatenated slice of resources, caching the result using the target path as its cache key. Each resource must have the same [media type].
+
+Hugo publishes the resource to the target path when you call its [`Publish`], [`Permalink`], or [`RelPermalink`] methods. 
+
+[media type]: https://en.wikipedia.org/wiki/Media_type
+[`publish`]: /methods/resource/publish
+[`permalink`]: /methods/resource/permalink
+[`relpermalink`]: /methods/resource/relpermalink
+
 ```go-html-template
 {{ $plugins := resources.Get "js/plugins.js" }}
 {{ $global := resources.Get "js/global.js" }}
 {{ $js := slice $plugins $global | resources.Concat "js/bundle.js" }}
 ```
-
-Asset files of the same [media type] can be bundled into one resource using the `resources.Concat` function which takes two arguments, the target path for the created resource bundle and a slice of resource objects to be concatenated.
-
-[media type]: https://en.wikipedia.org/wiki/Media_type
diff --git a/content/en/functions/resources/ExecuteAsTemplate.md b/content/en/functions/resources/ExecuteAsTemplate.md
index d17f0580c..5f7e58413 100644
--- a/content/en/functions/resources/ExecuteAsTemplate.md
+++ b/content/en/functions/resources/ExecuteAsTemplate.md
@@ -1,6 +1,6 @@
 ---
 title: resources.ExecuteAsTemplate
-description: Creates a resource from a Go template, parsed and executed with the given context.
+description: Returns a resource created from a Go template, parsed and executed with the given context.
 categories: []
 keywords: []
 action:
@@ -11,7 +11,13 @@ action:
   signatures: [resources.ExecuteAsTemplate TARGETPATH CONTEXT RESOURCE]
 ---
 
-Hugo publishes the resource to the target path when you call its`.Publish`, `.Permalink`, or `.RelPermalink` method. The resource is cached, using the target path as the cache key.
+The `resources.ExecuteAsTemplate` function returns a resource created from a Go template, parsed and executed with the given context, caching the result using the target path as its cache key.
+
+Hugo publishes the resource to the target path when you call its [`Publish`], [`Permalink`], or [`RelPermalink`] methods.
+
+[`publish`]: /methods/resource/publish
+[`permalink`]: /methods/resource/permalink
+[`relpermalink`]: /methods/resource/relpermalink
 
 Let's say you have a CSS file that you wish to populate with values from your site configuration:
 
diff --git a/content/en/functions/resources/FromString.md b/content/en/functions/resources/FromString.md
index 6c22b5310..75f48ad9c 100644
--- a/content/en/functions/resources/FromString.md
+++ b/content/en/functions/resources/FromString.md
@@ -1,6 +1,6 @@
 ---
 title: resources.FromString
-description: Creates a resource from a string.
+description: Returns a resource created from a string.
 categories: []
 keywords: []
 action:
@@ -11,7 +11,13 @@ action:
   signatures: [resources.FromString TARGETPATH STRING]
 ---
 
-Hugo publishes the resource to the target path when you call its`.Publish`, `.Permalink`, or `.RelPermalink` method. The resource is cached, using the target path as the cache key.
+The `resources.FromString` function returns a resource created from a string, caching the result using the target path as its cache key.
+
+Hugo publishes the resource to the target path when you call its [`Publish`], [`Permalink`], or [`RelPermalink`] methods.
+
+[`publish`]: /methods/resource/publish
+[`permalink`]: /methods/resource/permalink
+[`relpermalink`]: /methods/resource/relpermalink
 
 Let's say you need to publish a file named "site.json" in the root of your public directory, containing the build date, the Hugo version used to build the site, and the date that the content was last modified. For example: