Merge pull request #36042 from hashicorp/backport/main/quickly-desire…

…d-filly

Backport of Clarify single-removal behavior in `trimsuffix` and `trimprefix` docs into v1.10

website/docs/language/functions/trimprefix.mdx

@@ -7,7 +7,7 @@ description: |-
 
 # `trimprefix` Function
 
-`trimprefix` removes the specified prefix from the start of the given string. If the string does not start with the prefix, the string is returned unchanged.
+`trimprefix` removes the specified prefix from the start of the given string, but only once. If the string does not begin with the prefix, the original string is returned unchanged.
 
 ## Examples
 
@@ -21,6 +21,11 @@ world
 helloworld
 ```
 
+```
+> trimprefix("--hello", "-")
+-hello
+```
+
 ## Related Functions
 
 * [`trim`](/terraform/language/functions/trim) removes characters at the start and end of a string.

website/docs/language/functions/trimsuffix.mdx

@@ -7,7 +7,7 @@ description: |-
 
 # `trimsuffix` Function
 
-`trimsuffix` removes the specified suffix from the end of the given string.
+`trimsuffix` removes the specified suffix from the end of the given string, but only once, even if the suffix appears multiple times. If the suffix does not appear at the very end of the string, the original string is returned unchanged.
 
 ## Examples
 
@@ -16,6 +16,16 @@ description: |-
 hello
 ```
 
+```
+> trimsuffix("helloworld", "cat")
+helloworld
+```
+
+```
+> trimsuffix("hello--", "-")
+hello-
+```
+
 ## Related Functions
 
 * [`trim`](/terraform/language/functions/trim) removes characters at the start and end of a string.