docs: describe linking formats and languages #850

docs/content/configuration/content/linking/index.en.md

@@ -21,6 +21,14 @@ For the file system scenario, you are not allowed to change this value.
   disableExplicitIndexURLs = true
 {{< /multiconfig >}}
 
+## Legacy Cross-Language Links
+
+You can link to pages of different languages by appending the `lang` query parameter with the language code to the URL, e.g. `/my-page?lang=pir`.
+
+In previous releases of the theme you had to prepend the language code to the URL, e.g. `/pir/my-page` to achieve this.
+
+If you still need the old behavior, you can set `enableLegacyLanguageLinks=true` in your `hugo.toml`. Note that this legacy feature may be removed in the future.
+
 ## Patching the `relref` Shortcode
 
 {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} While the usage of `relref` is obsolete and discouraged by Hugo for a while, existing installations may still use it.

docs/content/configuration/customization/imageeffects.en.md

@@ -8,7 +8,7 @@ weight = 4
 
 This page shows you, how to configure custom [image effects](authoring/markdown#image-effects) on top of existing ones.
 
-This setting can also [be overridden by your front matter](authoring/imageeffects).
+This setting can also [be overridden by your front matter](authoring/linking/imageeffects).
 
 If you don't configure anything in your `hugo.toml`, the image effects default to
 

docs/content/configuration/customization/linkeffects.en.md

@@ -8,7 +8,7 @@ weight = 3
 
 This page shows you, how to configure custom [link effects](authoring/markdown#link-effects) on top of existing ones.
 
-This setting can also [be overridden by your front matter](authoring/linkeffects).
+This setting can also [be overridden by your front matter](authoring/linking/linkeffects).
 
 If you don't configure anything in your `hugo.toml`, the link effects default to