Improve url function examples

content/en/functions/urls/AbsLangURL.md

@@ -20,11 +20,11 @@ Use this function with both monolingual and multilingual configurations. The URL
 - The `baseURL` in site configuration
 - The language prefix, if any
 
-In examples that follow, the project is multilingual with content in both Español (`es`) and English (`en`). The default language is Español. The returned values are from the English site.
+In examples that follow, the project is multilingual with content in both English (`en`) and Spanish (`es`). The returned values are from the English site.
 
 ### Input does not begin with a slash
 
-If the input does not begin with a slash, the resulting URL will be correct regardless of the `baseURL`.
+If the input does not begin with a slash, the path in the resulting URL will be relative to the `baseURL` in your site configuration.
 
 With `baseURL = https://example.org/`
 
@@ -44,7 +44,7 @@ With `baseURL = https://example.org/docs/`
 
 ### Input begins with a slash
 
-If the input begins with a slash, the resulting URL will be incorrect when the `baseURL` includes a subdirectory. With a leading slash, the function returns a URL relative to the protocol+host section of the `baseURL`.
+If the input begins with a slash, the path in the resulting URL will be relative to the protocol+host of the `baseURL` in your site configuration.
 
 With `baseURL = https://example.org/`
 
@@ -61,7 +61,3 @@ With `baseURL = https://example.org/docs/`
 {{ absLangURL "/articles" }}  → https://example.org/en/articles
 {{ absLangURL "/style.css" }} → https://example.org/en/style.css
 ```
-
-{{% note %}}
-The last three examples are not desirable in most situations. As a best practice, never include a leading slash when using this function.
-{{% /note %}}

content/en/functions/urls/AbsURL.md

@@ -14,14 +14,14 @@ action:
 aliases: [/functions/absurl]
 ---
 
-With multilingual configurations, use the [`absLangURL`] function instead. The URL returned by this function depends on:
+With multilingual configurations, use the [`urls.AbsLangURL`] function instead. The URL returned by this function depends on:
 
 - Whether the input begins with a slash
 - The `baseURL` in site configuration
 
 ### Input does not begin with a slash
 
-If the input does not begin with a slash, the resulting URL will be correct regardless of the `baseURL`.
+If the input does not begin with a slash, the path in the resulting URL will be relative to the `baseURL` in your site configuration.
 
 With `baseURL = https://example.org/`
 
@@ -41,7 +41,7 @@ With `baseURL = https://example.org/docs/`
 
 #### Input begins with a slash
 
-If the input begins with a slash, the resulting URL will be incorrect when the `baseURL` includes a subdirectory. With a leading slash, the function returns a URL relative to the protocol+host section of the `baseURL`.
+If the input begins with a slash, the path in the resulting URL will be relative to the protocol+host of the `baseURL` in your site configuration.
 
 With `baseURL = https://example.org/`
 
@@ -59,8 +59,4 @@ With `baseURL = https://example.org/docs/`
 {{ absURL "/style.css" }} → https://example.org/style.css
 ```
 
-{{% note %}}
-The last three examples are not desirable in most situations. As a best practice, never include a leading slash when using this function.
-{{% /note %}}
-
-[`absLangURL`]: /functions/urls/abslangurl/
+[`urls.AbsLangURL`]: /functions/urls/abslangurl/

content/en/functions/urls/RelLangURL.md

@@ -46,7 +46,7 @@ With `baseURL = https://example.org/docs/`
 
 #### Input begins with a slash
 
-If the input begins with a slash, the resulting URL will be relative to the protocol+host portion of the `baseURL`.
+If the input begins with a slash, the resulting URL will be relative to the protocol+host of the `baseURL` in your site configuration.
 
 With `baseURL = https://example.org/`
 

content/en/functions/urls/RelURL.md

@@ -14,7 +14,7 @@ action:
 aliases: [/functions/relurl]
 ---
 
-With multilingual configurations, use the [`relLangURL`] function instead. The URL returned by this function depends on:
+With multilingual configurations, use the [`urls.RelLangURL`] function instead. The URL returned by this function depends on:
 
 - Whether the input begins with a slash
 - The `baseURL` in your site configuration
@@ -43,7 +43,7 @@ With `baseURL = https://example.org/docs/`
 
 #### Input begins with a slash
 
-If the input begins with a slash, the resulting URL will be relative to the protocol+host portion of the `baseURL`.
+If the input begins with a slash, the resulting URL will be relative to the protocol+host of the `baseURL` in your site configuration.
 
 With `baseURL = https://example.org/`
 
@@ -61,4 +61,4 @@ With `baseURL = https://example.org/docs/`
 {{ relURL "/style.css" }} → /style.css
 ```
 
-[`relLangURL`]: /functions/urls/rellangurl/
+[`urls.RelLangURL`]: /functions/urls/rellangurl/