From 21e80798f30a5a86c5b2cdccb1990c7ee9adaf97 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=B6ren=20Weber?= <mail@soeren-weber.de>
Date: Fri, 11 Oct 2024 23:01:56 +0200
Subject: [PATCH] docs: finalize dir structure of chapter 3 #567

---
 .../authoring/frontmatter/_index.en.md        |  39 +++---------------
 .../authoring/frontmatter/_index.pir.md       |   8 ++--
 .../{ => frontmatter}/designs/_index.en.md    |   2 +-
 .../{ => frontmatter}/designs/_index.pir.md   |   2 +-
 .../designs/pages-chapter.png                 | Bin
 .../designs/pages-default.png                 | Bin
 .../{ => frontmatter}/designs/pages-home.png  | Bin
 .../{ => frontmatter}/meta/_index.en.md       |   2 +-
 .../{ => frontmatter}/meta/_index.pir.md      |   2 +-
 .../navigationmenu/_index.en.md               |   2 +-
 .../navigationmenu/_index.pir.md              |   2 +-
 .../navigationmenu/frontmatter-icon.png       | Bin
 .../frontmatter/reference/_index.en.md        |  38 +++++++++++++++++
 .../frontmatter/reference/_index.pir.md       |   8 ++++
 .../{ => reference}/frontmatter.toml          |   0
 .../content/authoring/imageeffects.en.md      |   2 +-
 .../content/authoring/imageeffects.pir.md     |   2 +-
 exampleSite/content/authoring/markdown.en.md  |   2 +-
 exampleSite/content/authoring/markdown.pir.md |   2 +-
 .../customization/designs/index.en.md         |   2 +-
 .../customization/topbar/_index.en.md         |   2 +-
 .../{options => reference}/_index.en.md       |   0
 .../{options => reference}/_index.pir.md      |   0
 .../sidebar/navigationmenu/_index.en.md       |   2 +-
 .../introduction/releasenotes/2/0.en.md       |   2 +-
 .../introduction/releasenotes/2/4.en.md       |   2 +-
 .../introduction/releasenotes/2/8.en.md       |   2 +-
 .../introduction/releasenotes/2/9.en.md       |   8 ++--
 .../introduction/releasenotes/5/0.en.md       |   2 +-
 .../introduction/releasenotes/5/22.en.md      |   2 +-
 .../introduction/releasenotes/5/23.en.md      |   2 +-
 .../introduction/releasenotes/5/24.en.md      |   4 +-
 .../introduction/releasenotes/5/6.en.md       |   2 +-
 .../introduction/releasenotes/6/1.en.md       |   2 +-
 .../introduction/releasenotes/7/0.en.md       |   2 +-
 layouts/partials/version.txt                  |   2 +-
 36 files changed, 84 insertions(+), 67 deletions(-)
 rename exampleSite/content/authoring/{ => frontmatter}/designs/_index.en.md (99%)
 rename exampleSite/content/authoring/{ => frontmatter}/designs/_index.pir.md (90%)
 rename exampleSite/content/authoring/{ => frontmatter}/designs/pages-chapter.png (100%)
 rename exampleSite/content/authoring/{ => frontmatter}/designs/pages-default.png (100%)
 rename exampleSite/content/authoring/{ => frontmatter}/designs/pages-home.png (100%)
 rename exampleSite/content/authoring/{ => frontmatter}/meta/_index.en.md (97%)
 rename exampleSite/content/authoring/{ => frontmatter}/meta/_index.pir.md (90%)
 rename exampleSite/content/authoring/{ => frontmatter}/navigationmenu/_index.en.md (99%)
 rename exampleSite/content/authoring/{ => frontmatter}/navigationmenu/_index.pir.md (86%)
 rename exampleSite/content/authoring/{ => frontmatter}/navigationmenu/frontmatter-icon.png (100%)
 create mode 100644 exampleSite/content/authoring/frontmatter/reference/_index.en.md
 create mode 100644 exampleSite/content/authoring/frontmatter/reference/_index.pir.md
 rename exampleSite/content/authoring/frontmatter/{ => reference}/frontmatter.toml (100%)
 rename exampleSite/content/configuration/{options => reference}/_index.en.md (100%)
 rename exampleSite/content/configuration/{options => reference}/_index.pir.md (100%)

diff --git a/exampleSite/content/authoring/frontmatter/_index.en.md b/exampleSite/content/authoring/frontmatter/_index.en.md
index 2b7e0f970f..1453b86ca9 100644
--- a/exampleSite/content/authoring/frontmatter/_index.en.md
+++ b/exampleSite/content/authoring/frontmatter/_index.en.md
@@ -1,37 +1,8 @@
 +++
-description = "All front matter for the Relearn theme"
-tags = ["reference"]
-title = "Front Matter Reference"
-weight = 8
+alwaysopen = false
+description = "All things front matter"
+title = "Front Matter"
+weight = 2
 +++
 
-Every Hugo page must have front matter.
-
-In addition to [Hugo's standard front matter](https://gohugo.io/content-management/front-matter/#fields), the Relearn theme offers extras settings listed here.
-
-Throughout the documentation, theme-specific front matter is marked with a {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} badge.
-
-Add theme front matter directly to the root of your page's front matter. For example:
-
-{{< multiconfig fm=true >}}
-  math = true
-{{< /multiconfig >}}
-
-## Index
-
-{{% taxonomy "frontmatter" "h3" %}}
-
-## All Front Matter
-
-Here's a list of all available front matter with example values.  Default values are described in the [annotated example](#annotated-front-matter) below or in each front matter's documentation.
-
-{{< multiconfig fm=true >}}
-{{% include "frontmatter.toml" %}}
-{{< /multiconfig >}}
-
-## Annotated Front Matter
-
-````toml {title="toml"}
-+++
-{{% include "frontmatter.toml" %}}+++
-````
+{{% children containerstyle="div" style="h2" description=true %}}
diff --git a/exampleSite/content/authoring/frontmatter/_index.pir.md b/exampleSite/content/authoring/frontmatter/_index.pir.md
index 0bdead2bf4..30b1f20002 100644
--- a/exampleSite/content/authoring/frontmatter/_index.pir.md
+++ b/exampleSite/content/authoring/frontmatter/_index.pir.md
@@ -1,7 +1,7 @@
 +++
-description = "All front matter for the Relearn theme"
-tags = ["reference"]
-title = "Front Matter Reference"
-weight = 8
+alwaysopen = false
+description = "All things front matter"
+title = "Front Matter"
+weight = 2
 +++
 {{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/authoring/designs/_index.en.md b/exampleSite/content/authoring/frontmatter/designs/_index.en.md
similarity index 99%
rename from exampleSite/content/authoring/designs/_index.en.md
rename to exampleSite/content/authoring/frontmatter/designs/_index.en.md
index 7875dcfa37..ed967d46b2 100644
--- a/exampleSite/content/authoring/designs/_index.en.md
+++ b/exampleSite/content/authoring/frontmatter/designs/_index.en.md
@@ -1,7 +1,7 @@
 +++
 description = "How to vary layouts by using page designs"
 title = "Page Designs"
-weight = 5
+weight = 3
 +++
 
 A page is displayed by exactly one page design and represented by [Hugo's reserved `type` front matter](https://gohugo.io/content-management/front-matter/#type).
diff --git a/exampleSite/content/authoring/designs/_index.pir.md b/exampleSite/content/authoring/frontmatter/designs/_index.pir.md
similarity index 90%
rename from exampleSite/content/authoring/designs/_index.pir.md
rename to exampleSite/content/authoring/frontmatter/designs/_index.pir.md
index 15b77f93cb..3d573b09ce 100644
--- a/exampleSite/content/authoring/designs/_index.pir.md
+++ b/exampleSite/content/authoring/frontmatter/designs/_index.pir.md
@@ -1,6 +1,6 @@
 +++
 description = "How to vary layouts by using page designs"
 title = "Page Designs"
-weight = 5
+weight = 3
 +++
 {{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/authoring/designs/pages-chapter.png b/exampleSite/content/authoring/frontmatter/designs/pages-chapter.png
similarity index 100%
rename from exampleSite/content/authoring/designs/pages-chapter.png
rename to exampleSite/content/authoring/frontmatter/designs/pages-chapter.png
diff --git a/exampleSite/content/authoring/designs/pages-default.png b/exampleSite/content/authoring/frontmatter/designs/pages-default.png
similarity index 100%
rename from exampleSite/content/authoring/designs/pages-default.png
rename to exampleSite/content/authoring/frontmatter/designs/pages-default.png
diff --git a/exampleSite/content/authoring/designs/pages-home.png b/exampleSite/content/authoring/frontmatter/designs/pages-home.png
similarity index 100%
rename from exampleSite/content/authoring/designs/pages-home.png
rename to exampleSite/content/authoring/frontmatter/designs/pages-home.png
diff --git a/exampleSite/content/authoring/meta/_index.en.md b/exampleSite/content/authoring/frontmatter/meta/_index.en.md
similarity index 97%
rename from exampleSite/content/authoring/meta/_index.en.md
rename to exampleSite/content/authoring/frontmatter/meta/_index.en.md
index b91c6a41f8..8d9ca72acd 100644
--- a/exampleSite/content/authoring/meta/_index.en.md
+++ b/exampleSite/content/authoring/frontmatter/meta/_index.en.md
@@ -1,7 +1,7 @@
 +++
 description = "What page meta information can be set"
 title = "Meta Information"
-weight = 2
+weight = 1
 +++
 
 The theme adds social media meta tags including feature images for the [Open Graph](https://gohugo.io/templates/internal/#open-graph) protocol and [Twitter Cards](https://gohugo.io/templates/internal/#twitter-cards) to your site. These are configured as mentioned in the linked Hugo docs.
diff --git a/exampleSite/content/authoring/meta/_index.pir.md b/exampleSite/content/authoring/frontmatter/meta/_index.pir.md
similarity index 90%
rename from exampleSite/content/authoring/meta/_index.pir.md
rename to exampleSite/content/authoring/frontmatter/meta/_index.pir.md
index 7275b272e7..af217cefac 100644
--- a/exampleSite/content/authoring/meta/_index.pir.md
+++ b/exampleSite/content/authoring/frontmatter/meta/_index.pir.md
@@ -1,6 +1,6 @@
 +++
 description = "What page meta information can be set"
 title = "Meta Information"
-weight = 2
+weight = 1
 +++
 {{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/authoring/navigationmenu/_index.en.md b/exampleSite/content/authoring/frontmatter/navigationmenu/_index.en.md
similarity index 99%
rename from exampleSite/content/authoring/navigationmenu/_index.en.md
rename to exampleSite/content/authoring/frontmatter/navigationmenu/_index.en.md
index 197ec26f0b..c3ce4acc02 100644
--- a/exampleSite/content/authoring/navigationmenu/_index.en.md
+++ b/exampleSite/content/authoring/frontmatter/navigationmenu/_index.en.md
@@ -1,7 +1,7 @@
 +++
 description = "Per page behavior of the navigation menu"
 title = "Navigation Menu"
-weight = 4
+weight = 2
 +++
 
 ## Custom Title for Menu Entries
diff --git a/exampleSite/content/authoring/navigationmenu/_index.pir.md b/exampleSite/content/authoring/frontmatter/navigationmenu/_index.pir.md
similarity index 86%
rename from exampleSite/content/authoring/navigationmenu/_index.pir.md
rename to exampleSite/content/authoring/frontmatter/navigationmenu/_index.pir.md
index 23f5863c07..a3d1966547 100644
--- a/exampleSite/content/authoring/navigationmenu/_index.pir.md
+++ b/exampleSite/content/authoring/frontmatter/navigationmenu/_index.pir.md
@@ -1,6 +1,6 @@
 +++
 tags = ["reference"]
 title = "Navigation Menu"
-weight = 4
+weight = 2
 +++
 {{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/authoring/navigationmenu/frontmatter-icon.png b/exampleSite/content/authoring/frontmatter/navigationmenu/frontmatter-icon.png
similarity index 100%
rename from exampleSite/content/authoring/navigationmenu/frontmatter-icon.png
rename to exampleSite/content/authoring/frontmatter/navigationmenu/frontmatter-icon.png
diff --git a/exampleSite/content/authoring/frontmatter/reference/_index.en.md b/exampleSite/content/authoring/frontmatter/reference/_index.en.md
new file mode 100644
index 0000000000..5f68fcb159
--- /dev/null
+++ b/exampleSite/content/authoring/frontmatter/reference/_index.en.md
@@ -0,0 +1,38 @@
++++
+description = "All front matter for the Relearn theme"
+linkTitle = "Reference"
+tags = ["reference"]
+title = "Front Matter Reference"
+weight = 4
++++
+
+Every Hugo page must have front matter.
+
+In addition to [Hugo's standard front matter](https://gohugo.io/content-management/front-matter/#fields), the Relearn theme offers extras settings listed here.
+
+Throughout the documentation, theme-specific front matter is marked with a {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} badge.
+
+Add theme front matter directly to the root of your page's front matter. For example:
+
+{{< multiconfig fm=true >}}
+  math = true
+{{< /multiconfig >}}
+
+## Index
+
+{{% taxonomy "frontmatter" "h3" %}}
+
+## All Front Matter
+
+Here's a list of all available front matter with example values.  Default values are described in the [annotated example](#annotated-front-matter) below or in each front matter's documentation.
+
+{{< multiconfig fm=true >}}
+{{% include "frontmatter.toml" %}}
+{{< /multiconfig >}}
+
+## Annotated Front Matter
+
+````toml {title="toml"}
++++
+{{% include "frontmatter.toml" %}}+++
+````
diff --git a/exampleSite/content/authoring/frontmatter/reference/_index.pir.md b/exampleSite/content/authoring/frontmatter/reference/_index.pir.md
new file mode 100644
index 0000000000..416477aa6b
--- /dev/null
+++ b/exampleSite/content/authoring/frontmatter/reference/_index.pir.md
@@ -0,0 +1,8 @@
++++
+description = "All front matter for the Relearn theme"
+linkTitle = "Reference"
+tags = ["reference"]
+title = "Front Matter Reference"
+weight = 4
++++
+{{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/authoring/frontmatter/frontmatter.toml b/exampleSite/content/authoring/frontmatter/reference/frontmatter.toml
similarity index 100%
rename from exampleSite/content/authoring/frontmatter/frontmatter.toml
rename to exampleSite/content/authoring/frontmatter/reference/frontmatter.toml
diff --git a/exampleSite/content/authoring/imageeffects.en.md b/exampleSite/content/authoring/imageeffects.en.md
index cdfb8c5e9a..f6082f6731 100644
--- a/exampleSite/content/authoring/imageeffects.en.md
+++ b/exampleSite/content/authoring/imageeffects.en.md
@@ -2,7 +2,7 @@
 description = "How to apply graphical effects to your images"
 frontmatter = ["imageEffects"]
 title = "Image Effects"
-weight = 7
+weight = 4
 +++
 
 The theme offers [graphical effects](authoring/markdown#image-effects) for your linked images.
diff --git a/exampleSite/content/authoring/imageeffects.pir.md b/exampleSite/content/authoring/imageeffects.pir.md
index c6a96a6d4a..073cd412bc 100644
--- a/exampleSite/content/authoring/imageeffects.pir.md
+++ b/exampleSite/content/authoring/imageeffects.pir.md
@@ -2,6 +2,6 @@
 description = "How to apply graphical effects to your images"
 frontmatter = ["imageEffects"]
 title = "Image Effects"
-weight = 7
+weight = 4
 +++
 {{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/authoring/markdown.en.md b/exampleSite/content/authoring/markdown.en.md
index 884e8fd89c..0120897024 100644
--- a/exampleSite/content/authoring/markdown.en.md
+++ b/exampleSite/content/authoring/markdown.en.md
@@ -2,7 +2,7 @@
 description = "Reference of Commonmark and Markdown extensions"
 tags = ["reference"]
 title = "Markdown Syntax"
-weight = 6
+weight = 3
 +++
 
 Let's face it: Writing content for the web is tiresome. WYSIWYG editors help alleviate this task, but they generally result in horrible code, or worse yet, ugly web pages.
diff --git a/exampleSite/content/authoring/markdown.pir.md b/exampleSite/content/authoring/markdown.pir.md
index 471aa5149f..870e8c9ae1 100644
--- a/exampleSite/content/authoring/markdown.pir.md
+++ b/exampleSite/content/authoring/markdown.pir.md
@@ -2,6 +2,6 @@
 description = "Reference of Commonmark and Markdown extensions"
 tags = ["reference"]
 title = "Marrrkdown Rules"
-weight = 6
+weight = 3
 +++
 {{< piratify >}}
\ No newline at end of file
diff --git a/exampleSite/content/configuration/customization/designs/index.en.md b/exampleSite/content/configuration/customization/designs/index.en.md
index 8a7169e9a2..254899dee4 100644
--- a/exampleSite/content/configuration/customization/designs/index.en.md
+++ b/exampleSite/content/configuration/customization/designs/index.en.md
@@ -21,7 +21,7 @@ All shipped designs use the theme's framework from `themes/hugo-theme-learn/layo
 
 ## Using a Page Design
 
-Regardless of shipped or custom page design, you are [using them](authoring/designs) in the same way.
+Regardless of shipped or custom page design, you are [using them](authoring/frontmatter/designs) in the same way.
 
 ## Creating a Page Designs
 
diff --git a/exampleSite/content/configuration/customization/topbar/_index.en.md b/exampleSite/content/configuration/customization/topbar/_index.en.md
index 462e892847..0f1228db85 100644
--- a/exampleSite/content/configuration/customization/topbar/_index.en.md
+++ b/exampleSite/content/configuration/customization/topbar/_index.en.md
@@ -33,7 +33,7 @@ The theme ships with the following predefined buttons (from left to right in the
 
 - {{% button style="transparent" icon="bars" %}}{{% /button %}} [**sidebar**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/sidebar.html): opens the sidebar flyout if in mobile layout
 - {{% button style="transparent" icon="list-alt" %}}{{% /button %}} [**toc**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html): opens the table of contents in an overlay
-- {{% button style="transparent" icon="pen" %}}{{% /button %}} [**edit**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html): browses to the editable page if the `editURL` [parameter is set](configuration/options)
+- {{% button style="transparent" icon="pen" %}}{{% /button %}} [**edit**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html): browses to the editable page if the `editURL` [parameter is set](configuration/reference)
 - {{% button style="transparent" icon="print" %}}{{% /button %}} [**print**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html): browses to the chapter's printable page if [print support](configuration/appearance/topbar#print-support) was activated
 - {{% button style="transparent" icon="chevron-left" %}}{{% /button %}} [**prev**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/prev.html): browses to the previous page if there is one
 - {{% button style="transparent" icon="chevron-right" %}}{{% /button %}} [**next**](https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/next.html): browses to the next page if there is one
diff --git a/exampleSite/content/configuration/options/_index.en.md b/exampleSite/content/configuration/reference/_index.en.md
similarity index 100%
rename from exampleSite/content/configuration/options/_index.en.md
rename to exampleSite/content/configuration/reference/_index.en.md
diff --git a/exampleSite/content/configuration/options/_index.pir.md b/exampleSite/content/configuration/reference/_index.pir.md
similarity index 100%
rename from exampleSite/content/configuration/options/_index.pir.md
rename to exampleSite/content/configuration/reference/_index.pir.md
diff --git a/exampleSite/content/configuration/sidebar/navigationmenu/_index.en.md b/exampleSite/content/configuration/sidebar/navigationmenu/_index.en.md
index 3eca41b0fb..620829f95d 100644
--- a/exampleSite/content/configuration/sidebar/navigationmenu/_index.en.md
+++ b/exampleSite/content/configuration/sidebar/navigationmenu/_index.en.md
@@ -18,7 +18,7 @@ All configurations options apply to all pages but can be changed in each page's
   alwaysopen = true
 {{< /multiconfig >}}
 
-See the [user guide](authoring/navigationmenu#expand-state-of-nested-sections) how this setting will be applied.
+See the [user guide](authoring/frontmatter/navigationmenu#expand-state-of-nested-sections) how this setting will be applied.
 
 ## Expander for Nested Sections
 
diff --git a/exampleSite/content/introduction/releasenotes/2/0.en.md b/exampleSite/content/introduction/releasenotes/2/0.en.md
index 426ab51329..93360fb33e 100644
--- a/exampleSite/content/introduction/releasenotes/2/0.en.md
+++ b/exampleSite/content/introduction/releasenotes/2/0.en.md
@@ -24,7 +24,7 @@ weight = -0
 
 ### New
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus in the front matter. Please see further [documentation](authoring/navigationmenu#expand-state-of-nested-sections) for possible values and default behavior.
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus in the front matter. Please see further [documentation](authoring/frontmatter/navigationmenu#expand-state-of-nested-sections) for possible values and default behavior.
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} New partials for defining pre/post content for menu items and the content. See [documentation](configuration/customization/partials) for further reading.
 
diff --git a/exampleSite/content/introduction/releasenotes/2/4.en.md b/exampleSite/content/introduction/releasenotes/2/4.en.md
index 8208f9b1c0..0334d661cd 100644
--- a/exampleSite/content/introduction/releasenotes/2/4.en.md
+++ b/exampleSite/content/introduction/releasenotes/2/4.en.md
@@ -16,7 +16,7 @@ weight = -4
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Hidden pages are displayed by default in their according tags page. You can now turn off this behavior by setting `disableTagHiddenPages=true` in your `hugo.toml`.
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus for the whole site by setting the `alwaysopen` option in your `hugo.toml`. Please see further [documentation](authoring/navigationmenu#expand-state-of-nested-sections) for possible values and default behavior.
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus for the whole site by setting the `alwaysopen` option in your `hugo.toml`. Please see further [documentation](authoring/frontmatter/navigationmenu#expand-state-of-nested-sections) for possible values and default behavior.
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} New front matter `ordersectionsby` option to change immediate children sorting in menu and `children` shortcode. Possible values are `title` or `weight`.
 
diff --git a/exampleSite/content/introduction/releasenotes/2/8.en.md b/exampleSite/content/introduction/releasenotes/2/8.en.md
index dcfcdc1c83..6683400b1d 100644
--- a/exampleSite/content/introduction/releasenotes/2/8.en.md
+++ b/exampleSite/content/introduction/releasenotes/2/8.en.md
@@ -16,4 +16,4 @@ weight = -8
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The theme now supports favicons served from `static/images/` named as `favicon` or `logo` in SVG, PNG or ICO format [out of the box](configuration/appearance/branding#change-the-favicon). An overridden partial `layouts/partials/favicon.html` may not be necessary anymore in most cases.
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can hide the table of contents menu for the whole site by setting the `disableToc` option in your `hugo.toml`. For an example see [the example configuration](configuration/options).
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can hide the table of contents menu for the whole site by setting the `disableToc` option in your `hugo.toml`. For an example see [the example configuration](configuration/reference).
diff --git a/exampleSite/content/introduction/releasenotes/2/9.en.md b/exampleSite/content/introduction/releasenotes/2/9.en.md
index 7eb3e9a6ba..167de8f260 100644
--- a/exampleSite/content/introduction/releasenotes/2/9.en.md
+++ b/exampleSite/content/introduction/releasenotes/2/9.en.md
@@ -16,9 +16,9 @@ weight = -9
 
   | Type          | Non-Standard                     | Standard               |
   |---------------|----------------------------------|------------------------|
-  | Branch bundle | `configuration/options/_index.md` | `configuration/options` |
-  | Leaf bundle   | `configuration/options/index.md`  | `configuration/options` |
-  | Page          | `configuration/options.md`        | `configuration/options` |
+  | Branch bundle | `configuration/reference/_index.md` | `configuration/reference` |
+  | Leaf bundle   | `configuration/reference/index.md`  | `configuration/reference` |
+  | Page          | `configuration/reference.md`        | `configuration/reference` |
 
   If you've linked from a page of one language to a page of another language, conversion is a bit more difficult but [Hugo got you covered](https://gohugo.io/content-management/cross-references/#link-to-another-language-version) as well.
 
@@ -29,7 +29,7 @@ weight = -9
   You may see errors on the console after the update in the form:
 
   ````shell
-  ERROR 2021/11/19 22:29:10 [en] REF_NOT_FOUND: Ref "configuration/options/_index.md": "hugo-theme-relearn\exampleSite\content\_index.en.md:19:22": page not found
+  ERROR 2021/11/19 22:29:10 [en] REF_NOT_FOUND: Ref "configuration/reference/_index.md": "hugo-theme-relearn\exampleSite\content\_index.en.md:19:22": page not found
   ````
 
   In this case, you must apply one of two options:
diff --git a/exampleSite/content/introduction/releasenotes/5/0.en.md b/exampleSite/content/introduction/releasenotes/5/0.en.md
index 139b29d01c..f596d67c1e 100644
--- a/exampleSite/content/introduction/releasenotes/5/0.en.md
+++ b/exampleSite/content/introduction/releasenotes/5/0.en.md
@@ -18,7 +18,7 @@ weight = -0
 
 ### Change
 
-- {{% badge style="note" title=" " %}}Change{{% /badge %}} The way [archetypes](authoring/designs) are used to generate output has changed. The new systems allows you, to redefine existing archetypes or even generate your own ones.
+- {{% badge style="note" title=" " %}}Change{{% /badge %}} The way [archetypes](authoring/frontmatter/designs) are used to generate output has changed. The new systems allows you, to redefine existing archetypes or even generate your own ones.
 
   Your existing markdown files will still work like before and therefore you don't need to change anything after the upgrade. Nevertheless, it is recommended to adapt your existing markdown files to the new way as follows:
 
diff --git a/exampleSite/content/introduction/releasenotes/5/22.en.md b/exampleSite/content/introduction/releasenotes/5/22.en.md
index 72ec196794..c21be0e003 100644
--- a/exampleSite/content/introduction/releasenotes/5/22.en.md
+++ b/exampleSite/content/introduction/releasenotes/5/22.en.md
@@ -16,7 +16,7 @@ weight = -22
 
 - {{% badge style="note" title=" " %}}Change{{% /badge %}} You can now have structural sections in the hierarchical menu without generating a page for it.
 
-  This can come in handy, if content for such a section page doesn't make much sense to you. See [the documentation](authoring/navigationmenu#disable-section-pages) for how to do this.
+  This can come in handy, if content for such a section page doesn't make much sense to you. See [the documentation](authoring/frontmatter/navigationmenu#disable-section-pages) for how to do this.
 
   This feature may require you to make changes to your existing installation if you are already using _[shortcuts to pages inside of your project](configuration/sidebar/shortcutmenu#displaying-pages-only-in-the-shortcuts-menu)_ with a _headless branch parent_.
 
diff --git a/exampleSite/content/introduction/releasenotes/5/23.en.md b/exampleSite/content/introduction/releasenotes/5/23.en.md
index 70dbcc1913..a649106040 100644
--- a/exampleSite/content/introduction/releasenotes/5/23.en.md
+++ b/exampleSite/content/introduction/releasenotes/5/23.en.md
@@ -36,7 +36,7 @@ weight = -23
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} It is now possible to adjust the menu width for your whole site. [See the docs](configuration/sidebar/width).
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} This release adds social media meta tags for the Open Graph protocol and Twitter Cards to your site. [See the docs](authoring/meta).
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} This release adds social media meta tags for the Open Graph protocol and Twitter Cards to your site. [See the docs](authoring/frontmatter/meta).
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} This release comes with additional sort options for the menu and the [`children` shortcode](shortcodes/children). Both will now accept the following values: `weight`, `title`, `linktitle`, `modifieddate`, `expirydate`, `publishdate`, `date`, `length` or `default` (adhering to Hugo's default sort order).
 
diff --git a/exampleSite/content/introduction/releasenotes/5/24.en.md b/exampleSite/content/introduction/releasenotes/5/24.en.md
index a2d1e26df8..97eaa18447 100644
--- a/exampleSite/content/introduction/releasenotes/5/24.en.md
+++ b/exampleSite/content/introduction/releasenotes/5/24.en.md
@@ -42,9 +42,9 @@ weight = -24
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Improvements for accessibility when tabbing through the page for images, links and tab handles.
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The `editURL` config parameter is now [overwritable in your pages front matter](authoring/frontmatter). In addition it received more versatility by letting you control where to put the file path into the URL. This is achieved by replacing the variable `${FilePath}` in your URL by the pages file path. You don't need to change anything in your existing configuration as the old way without the replacement variable still works.
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The `editURL` config parameter is now [overwritable in your pages front matter](authoring/frontmatter/reference). In addition it received more versatility by letting you control where to put the file path into the URL. This is achieved by replacing the variable `${FilePath}` in your URL by the pages file path. You don't need to change anything in your existing configuration as the old way without the replacement variable still works.
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The themes [config](configuration/options) and [front matter](authoring/frontmatter) options received a comprehensive documentation update. In addition the theme switched from `config.toml` to `hugo.toml`.
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The themes [config](configuration/reference) and [front matter](authoring/frontmatter/reference) options received a comprehensive documentation update. In addition the theme switched from `config.toml` to `hugo.toml`.
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Restored compatibility with Hugo versions {{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" title=" " %}}0.121.0{{% /badge %}} or higher for the [`highlight` shortcode](shortcodes/highlight). This does not change the minimum required Hugo version.
 
diff --git a/exampleSite/content/introduction/releasenotes/5/6.en.md b/exampleSite/content/introduction/releasenotes/5/6.en.md
index c2e623f48d..3141fcbf2a 100644
--- a/exampleSite/content/introduction/releasenotes/5/6.en.md
+++ b/exampleSite/content/introduction/releasenotes/5/6.en.md
@@ -24,7 +24,7 @@ weight = -6
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You are now able to turn off the generation of generator meta tags in your HTML head to hide the used versions of Hugo and this theme.
 
-  To [configure this](configuration/options) in your `hugo.toml` make sure to set Hugo's `disableHugoGeneratorInject=true` **and** also `[params] disableGeneratorVersion=true`, otherwise Hugo will generate a meta tag into your home page automagically.
+  To [configure this](configuration/reference) in your `hugo.toml` make sure to set Hugo's `disableHugoGeneratorInject=true` **and** also `[params] disableGeneratorVersion=true`, otherwise Hugo will generate a meta tag into your home page automagically.
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Creation of your project gets a little bit faster with this release.
 
diff --git a/exampleSite/content/introduction/releasenotes/6/1.en.md b/exampleSite/content/introduction/releasenotes/6/1.en.md
index ac23e881d1..3f203be2f7 100644
--- a/exampleSite/content/introduction/releasenotes/6/1.en.md
+++ b/exampleSite/content/introduction/releasenotes/6/1.en.md
@@ -18,7 +18,7 @@ weight = -1
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The [`openapi` shortcode](shortcodes/openapi) is now able to resolve links to resources as well as to files in the file system (the old behavior). You can configure to generate warnings or errors during build by setting `openapi.errorlevel` to either `warning` or `error` in your `hugo.toml` if a path can not be resolved.
 
-- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Shortcodes supporting an `errorlevel` configuration can now have overridden values in the [front matter](authoring/frontmatter) section of each individual page.
+- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Shortcodes supporting an `errorlevel` configuration can now have overridden values in the [front matter](authoring/frontmatter/reference) section of each individual page.
 
 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The theme now comes with its own overridden version of the `relref` shortcode.
 
diff --git a/exampleSite/content/introduction/releasenotes/7/0.en.md b/exampleSite/content/introduction/releasenotes/7/0.en.md
index eaf927c6cc..b293bcbb01 100644
--- a/exampleSite/content/introduction/releasenotes/7/0.en.md
+++ b/exampleSite/content/introduction/releasenotes/7/0.en.md
@@ -83,7 +83,7 @@ weight = -0
 
   The docs now clearly differentiate between [configuration of your site](configuration), all things [writing page content](authoring) and the [shortcodes docs](shortcodes) that cover both topics, configuration and usage.
 
-  To give you a better overview of what's possible with the theme, we introduced reference pages for all theme [configuration options](configuration/options) and [front matter](authoring/frontmatter) and mark each occurrence of such on all pages with the badges {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} and {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}}.
+  To give you a better overview of what's possible with the theme, we introduced reference pages for all theme [configuration options](configuration/reference) and [front matter](authoring/frontmatter/reference) and mark each occurrence of such on all pages with the badges {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} and {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}}.
 
   Also, a lot of previously undocumented features are now included, namely
 
diff --git a/layouts/partials/version.txt b/layouts/partials/version.txt
index 872214daf4..b28c9e2837 100644
--- a/layouts/partials/version.txt
+++ b/layouts/partials/version.txt
@@ -1 +1 @@
-6.4.0+8907aa613bb6130bcdc8323312b8fe8dbbeed9ce
\ No newline at end of file
+6.4.0+7e0a04d9aaef0021790e51535ebfcd96b902a0f0
\ No newline at end of file