♻️ Dark mode rewrite

exampleSite/content/docs/version-2/_index.md

@@ -28,7 +28,7 @@ A highly requested feature, Congo is now multilingual! If you publish your conte
 
 <div class="text-2xl text-center" style="font-size: 2.8rem">:flag-au: :de: :fr: :es: :cn: :brazil: :tr:</div>
 
-Thanks to submissions from the community, Congo has already been translated into [seven languages](https://github.com/jpanther/congo/tree/dev/i18n) with more to be added over time. By the way, pull requests for new languages are always welcome!
+Thanks to submissions from the community, Congo has already been translated into [seven languages](https://github.com/jpanther/congo/tree/dev/i18n) with more to be added over time. By the way, [pull requests](https://github.com/jpanther/congo/pulls) for new languages are always welcome!
 
 ## RTL language support
 
@@ -87,6 +87,10 @@ The new image resizing features also provide full control over `alt` and `title`
 
 There's countless other minor changes to explore. From being able to display taxonomies on articles and list pages, to using the new `headline` author parameter to customise your homepage. There's also improved JSON-LD strucured data which further optimises SEO performance. Plus the entire theme has had extra polish to ensure a consistent design language.
 
+:rocket: Check out the [full changelog](https://github.com/jpanther/congo/blob/dev/CHANGELOG.md) to learn more.
+
+## Next steps
+
 If you're ready to upgrade, read the [upgrading from version 1 guide]({{< ref "upgrade" >}}) to get started. If you're new to Congo, check out the [Installation guide]({{< ref "docs/installation" >}}) to begin a new project.
 
 ---

exampleSite/content/docs/version-2/upgrade/index.md

@@ -117,6 +117,11 @@ If you're using a language other than English, provide a `defaultContentLanguage
 # config/_default/config.toml
 
 defaultContentLanguage = "en"
+
+enableRobotsTXT = true
+paginate = 10
+summaryLength = 0
+
 [outputs]
   home = ["HTML", "RSS", "JSON"]
 ```
@@ -139,11 +144,17 @@ The recommended settings are as follows, which includes any headings in the Mark
 
 A number of new theme parameters have been introduced in Congo 2.0. Some minor changes are requried to existing configurations. Remember, the theme will always revert to a sensible default if a parameter is not provided.
 
-The follow parameters have been **renamed**:
+The way that dark mode works in Congo has been changed to allow greater flexibility around configuration. The old `darkMode` and `darkToggle` parameters have been **removed and replaced** by three new parameters. These new options operate independently of each other, making it possible to force the appearance while still allowing the user to override.
 
-`darkToggle` **→** `showDarkToggle`
+<!-- prettier-ignore-start -->
+| New parameter | Type | Default | Description |
+| --- | --- | --- | --- |
+| `defaultAppearance` | String | `"light"` | Default theme appearance; either `light` or `dark`.<br>:warning: _Setting this to `light` replicates the old `darkMode = false` setting, while `dark` replicates `darkMode = true`._ |
+| `autoSwitchAppearance` | Boolean | `true` | Whether the theme appearance automatically switches based upon the operating system preference. Set to `false` to force the site to always use the `defaultAppearance`. <br>:warning: _Setting this to `true` replicates the old `darkMode = "auto"` setting._ |
+| `showAppearanceSwitcher` | Boolean | `false` | Whether the theme appearance switcher is dispalyed in the site footer. <br>:warning: _This parameter replaces `darkToggle`._ |
+<!-- prettier-ignore-end -->
 
-The following table outlines some key **new parameters** that control new features in version 2:
+The following table outlines some other key **new parameters** that control new features in version 2:
 
 | New parameter                 | Type    | Default |
 | ----------------------------- | ------- | ------- |