aboutsummaryrefslogtreecommitdiffhomepage
path: root/content/en/variables/_common
diff options
context:
space:
mode:
Diffstat (limited to 'content/en/variables/_common')
-rw-r--r--content/en/variables/_common/_index.md13
-rw-r--r--content/en/variables/_common/consistent-terminology.md20
2 files changed, 33 insertions, 0 deletions
diff --git a/content/en/variables/_common/_index.md b/content/en/variables/_common/_index.md
new file mode 100644
index 000000000..47d5812fb
--- /dev/null
+++ b/content/en/variables/_common/_index.md
@@ -0,0 +1,13 @@
+---
+cascade:
+ _build:
+ list: never
+ publishResources: false
+ render: never
+---
+
+<!--
+Files within this headless branch bundle are markdown snippets. Each file must contain front matter delimiters, though front matter fields are not required.
+
+Include the rendered content using the "include" shortcode.
+-->
diff --git a/content/en/variables/_common/consistent-terminology.md b/content/en/variables/_common/consistent-terminology.md
new file mode 100644
index 000000000..8774c817b
--- /dev/null
+++ b/content/en/variables/_common/consistent-terminology.md
@@ -0,0 +1,20 @@
+---
+# Do not remove front matter.
+---
+
+{{% note %}}
+We are making an effort to unify our [terminology], and to use these terms consistently throughout the documentation.
+
+Historically, we have inconsistently referred to the items on this page as [functions], [parameters], [variables], or [methods]. They are not functions, parameters, or variables; they are methods.
+
+This page will remain in place as readers become familiar with the unified terminology. See the [methods section] for a list of methods by [object], or the [methods quick reference guide].
+
+[functions]: /getting-started/glossary/#function
+[methods quick reference guide]: /quick-reference/methods
+[methods section]: /methods
+[methods]: /getting-started/glossary/#method
+[object]: /getting-started/glossary/#object
+[parameters]: /getting-started/glossary/#parameter
+[terminology]: /getting-started/glossary/
+[variables]: /getting-started/glossary/#variable
+{{% /note %}}