content: Replace "scratch pad" with clearer data structure terminology

jmooring · web-flow · commit 8875ef7fe631 · 2026-05-28T12:03:21.000-07:00
diff --git a/content/en/_common/scratch-pad-scope.md b/content/en/_common/scratch-pad-scope.md
@@ -4,7 +4,7 @@ _comment: Do not remove front matter.
 
 ## Scope
 
-The method or function used to create a scratch pad determines its scope. For example, use the `Store` method on a `Page` object to create a scratch pad scoped to the page.
+The method or function used to create the data structure determines its scope. For example, use the `Store` method on a `Page` object to create a data structure scoped to the page.
 
 Scope|Method or function
 :--|:--
diff --git a/content/en/_common/store-methods.md b/content/en/_common/store-methods.md
@@ -4,7 +4,7 @@
 
 ## Methods
 
-Use these methods on the scratch pad.
+Use these methods on the data structure.
 
 `Set`
 : Sets the value of the given key.
diff --git a/content/en/_common/store-scope.md b/content/en/_common/store-scope.md
@@ -0,0 +1,21 @@
+---
+_comment: Do not remove front matter.
+---
+
+## Scope
+
+The method or function used to create the data structure determines its scope. For example, use the `Store` method on a `Page` object to create a data structure scoped to the page.
+
+Scope|Method or function
+:--|:--
+page|[`PAGE.Store`]
+site|[`SITE.Store`]
+global|[`hugo.Store`]
+local|[`collections.NewScratch`]
+shortcode|[`SHORTCODE.Store`]
+
+[`page.store`]: /methods/page/store
+[`site.store`]: /methods/site/store
+[`hugo.store`]: /functions/hugo/store
+[`collections.newscratch`]: functions/collections/newscratch
+[`shortcode.store`]: /methods/shortcode/store
diff --git a/content/en/content-management/content-adapters.md b/content/en/content-management/content-adapters.md
@@ -85,7 +85,7 @@ Use these methods within a content adapter.
   > Methods that depend on built pages, such as `Site.Pages`, are unavailable at this stage and return an error.
 
 `Store`
-: (`maps.Scratch`) Returns a persistent "scratch pad" to store and manipulate data. The main use case for this is to transfer values between executions when [EnableAllLanguages](#enablealllanguages) is set. See [examples](/methods/page/store/).
+: (`maps.Scratch`) Returns a persistent data structure for storing and manipulating keyed values. The main use case for this is to transfer values between executions when [EnableAllLanguages](#enablealllanguages) is set. See [examples](/methods/page/store/).
 
   ```go-html-template {file="content/books/_content.gotmpl"}
   {{ .Store.Set "key" "value" }}
diff --git a/content/en/functions/collections/NewScratch.md b/content/en/functions/collections/NewScratch.md
@@ -1,6 +1,6 @@
 ---
 title: collections.NewScratch
-description: Returns a locally scoped "scratch pad" to store and manipulate data.
+description: Returns a locally scoped persistent data structure for storing and manipulating keyed values.
 categories: []
 keywords: []
 params:
@@ -10,11 +10,11 @@ params:
     signatures: [collections.NewScratch]
 ---
 
-Use the `collections.NewScratch` function to create a locally scoped [scratch pad](g) to store and manipulate data. To create a scratch pad with a different [scope](g), refer to the [scope](#scope) section below.
+Use the `collections.NewScratch` function to create a locally scoped persistent data structure for storing and manipulating keyed values. To create a data structure with a different [scope](g), refer to the [scope](#scope) section below.
 
 ## Methods
 
-Use these methods on the scratch pad.
+Use these methods on the data structure.
 
 `Set`
 : Sets the value of the given key.
@@ -110,4 +110,4 @@ Use these methods on the scratch pad.
   {{ $map := $s.Values }}
   ```
 
-{{% include "_common/scratch-pad-scope.md" %}}
+{{% include "_common/store-scope.md" %}}
diff --git a/content/en/functions/hugo/Store.md b/content/en/functions/hugo/Store.md
@@ -1,6 +1,6 @@
 ---
 title: hugo.Store
-description: Returns a globally scoped "scratch pad" to store and manipulate data.
+description: Returns a globally scoped persistent data structure for storing and manipulating keyed values.
 categories: []
 keywords: []
 params:
@@ -11,11 +11,11 @@ params:
 
 {{< new-in 0.139.0 />}}
 
-Use the `hugo.Store` function to create a globally scoped [scratch pad](g) to store and manipulate data. To create a scratch pad with a different [scope](g), refer to the [scope](#scope) section below.
+Use the `hugo.Store` function to create a globally scoped persistent data structure for storing and manipulating keyed values. To create a data structure with a different [scope](g), refer to the [scope](#scope) section below.
 
 ## Methods
 
-Use these methods on the scratch pad.
+Use these methods on the data structure.
 
 `Set`
 : Sets the value of the given key.
@@ -91,13 +91,13 @@ Use these methods on the scratch pad.
   {{ hugo.Store.Delete "greeting" }}
   ```
 
-{{% include "_common/scratch-pad-scope.md" %}}
+{{% include "_common/store-scope.md" %}}
 
 ## Determinate values
 
-The `Store` method is often used to set scratch pad values within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the scratch pad values are indeterminate until Hugo renders the page content.
+The `Store` method is often used to set values within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the stored values are indeterminate until Hugo renders the page content.
 
-If you need to access a scratch pad value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
+If you need to access a stored value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
 
 ```go-html-template
 {{ $noop := .Content }}
diff --git a/content/en/methods/page/Scratch.md b/content/en/methods/page/Scratch.md
@@ -1,6 +1,6 @@
 ---
 title: Scratch
-description: Returns a "scratch pad" to store and manipulate data, scoped to the current page.
+description: Returns a persistent data structure for storing and manipulating keyed values, scoped to the current page.
 categories: []
 keywords: []
 params:
diff --git a/content/en/methods/page/Store.md b/content/en/methods/page/Store.md
@@ -1,6 +1,6 @@
 ---
 title: Store
-description: Returns a "scratch pad" to store and manipulate data, scoped to the current page.
+description: Returns a persistent data structure for storing and manipulating keyed values, scoped to the current page.
 categories: []
 keywords: []
 params:
@@ -10,17 +10,17 @@ params:
 aliases: [/functions/store/,/extras/scratch/,/doc/scratch/,/functions/scratch]
 ---
 
-Use the `Store` method on a `Page` object to create a [scratch pad](g) to store and manipulate data, scoped to the current page. To create a scratch pad with a different [scope](g), refer to the [scope](#scope) section below.
+Use the `Store` method on a `Page` object to create a persistent data structure for storing and manipulating keyed values, scoped to the current page. To create a data structure with a different [scope](g), refer to the [scope](#scope) section below.
 
 {{% include "_common/store-methods.md" %}}
 
-{{% include "_common/scratch-pad-scope.md" %}}
+{{% include "_common/store-scope.md" %}}
 
 ## Determinate values
 
-The `Store` method is often used to set scratch pad values within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the scratch pad values are indeterminate until Hugo renders the page content.
+The `Store` method is often used to set values within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the stored values are indeterminate until Hugo renders the page content.
 
-If you need to access a scratch pad value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
+If you need to access a stored value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
 
 ```go-html-template
 {{ $noop := .Content }}
diff --git a/content/en/methods/shortcode/Scratch.md b/content/en/methods/shortcode/Scratch.md
@@ -1,6 +1,6 @@
 ---
 title: Scratch
-description: Returns a "scratch pad" to store and manipulate data, scoped to the current shortcode.
+description: Returns a persistent data structure for storing and manipulating keyed values, scoped to the current shortcode.
 categories: []
 keywords: []
 params:
diff --git a/content/en/methods/shortcode/Store.md b/content/en/methods/shortcode/Store.md
@@ -1,6 +1,6 @@
 ---
 title: Store
-description: Returns a "scratch pad" to store and manipulate data, scoped to the current shortcode.
+description: Returns a persistent data structure for storing and manipulating keyed values, scoped to the current shortcode.
 categories: []
 keywords: []
 params:
@@ -11,14 +11,14 @@ params:
 
 {{< new-in 0.139.0 />}}
 
-Use the `Store` method to create a [scratch pad](g) to store and manipulate data, scoped to the current shortcode. To create a scratch pad with a different [scope](g), refer to the [scope](#scope) section below.
+Use the `Store` method to create a persistent data structure for storing and manipulating keyed values, scoped to the current shortcode. To create a data structure with a different [scope](g), refer to the [scope](#scope) section below.
 
 > [!note]
 > With the introduction of the [`newScratch`] function, and the ability to [assign values to template variables] after initialization, the `Store` method within a shortcode is mostly obsolete.
 
 {{% include "_common/store-methods.md" %}}
 
-{{% include "_common/scratch-pad-scope.md" %}}
+{{% include "_common/store-scope.md" %}}
 
 [`newScratch`]: /functions/collections/newScratch/
 [assign values to template variables]: https://go.dev/doc/go1.11#texttemplatepkgtexttemplate
diff --git a/content/en/methods/site/Store.md b/content/en/methods/site/Store.md
@@ -1,6 +1,6 @@
 ---
 title: Store
-description: Returns a "scratch pad" to store and manipulate data, scoped to the current site.
+description: Returns a persistent data structure for storing and manipulating keyed values, scoped to the current site.
 categories: []
 keywords: []
 params:
@@ -11,11 +11,11 @@ params:
 
 {{< new-in 0.139.0 />}}
 
-Use the `Store` method on a `Site` object to create a [scratch pad](g) to store and manipulate data, scoped to the current site. To create a scratch pad with a different [scope](g), refer to the [scope](#scope) section below.
+Use the `Store` method on a `Site` object to create a persistent data structure for storing and manipulating keyed values, scoped to the current site. To create a data structure with a different [scope](g), refer to the [scope](#scope) section below.
 
 ## Methods
 
-Use these methods on the scratch pad.
+Use these methods on the data structure.
 
 `Set`
 : Sets the value of a given key.
@@ -91,13 +91,13 @@ Use these methods on the scratch pad.
   {{ site.Store.Delete "greeting" }}
   ```
 
-{{% include "_common/scratch-pad-scope.md" %}}
+{{% include "_common/store-scope.md" %}}
 
 ## Determinate values
 
-The `Store` method is often used to set scratch pad values within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the scratch pad values are indeterminate until Hugo renders the page content.
+The `Store` method is often used to set values within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the stored values are indeterminate until Hugo renders the page content.
 
-If you need to access a scratch pad value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
+If you need to access a stored value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
 
 ```go-html-template
 {{ $noop := .Content }}
diff --git a/content/en/quick-reference/glossary/scratch-pad.md b/content/en/quick-reference/glossary/scratch-pad.md
diff --git a/content/en/troubleshooting/faq.md b/content/en/troubleshooting/faq.md
@@ -82,9 +82,9 @@ Why isn't Hugo's development server detecting file changes?
   In these cases, instead of monitoring native file system events, use the `--poll` command line flag. For example, to poll the project files every 700 milliseconds, use `--poll 700ms`.
 
 Why is my page Store missing a value?
-: The [`Store`] method on a `Page` object allows you to create a [scratch pad](g) on the given page to store and manipulate data. Values are often set within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the scratch pad values are not determinate until Hugo renders the page content.
+: The [`Store`] method on a `Page` object creates a persistent data structure for storing and manipulating keyed values on the given page. Values are often set within a _shortcode_ template, a _partial_ template called by a _shortcode_ template, or by a _render hook_ template. In all three cases, the stored values are not determinate until Hugo renders the page content.
 
-  If you need to access a scratch pad value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
+  If you need to access a stored value from a parent template, and the parent template has not yet rendered the page content, you can trigger content rendering by assigning the returned value to a [noop](g) variable:
 
   ```go-html-template
   {{ $noop := .Content }}
