flarum · askvortsov1 · Nov 28, 2024 · Nov 28, 2024 · Nov 28, 2024 · Nov 28, 2024
diff --git a/docs/README.md b/docs/README.md
@@ -6,7 +6,7 @@ slug: /
 
 Flarum is a delightfully simple discussion platform for your website. It's fast, free, and easy to use, with all the features you need to run a successful community. It's also extremely extensible, allowing for ultimate customizability.
 
-![Flarum Home Screenshot](/en/img/home_screenshot.png)
+![Flarum Home Screenshot](./assets/home_screenshot.png)
 
 ## Goals
 
@@ -16,7 +16,7 @@ Flarum is the combined successor of [esoTalk](https://github.com/esotalk/esoTalk
 
 * **Beautiful and responsive.** This is forum software for humans. Flarum is carefully designed to be consistent and intuitive across platforms, out-of-the-box.
 
-* **Powerful and extensible.** Customize, extend, and integrate Flarum to suit your community. Flarum’s architecture is amazingly flexible, with a [powerful Extension API](/extend/README.md).
+* **Powerful and extensible.** Customize, extend, and integrate Flarum to suit your community. Flarum’s architecture is amazingly flexible, with a [powerful Extension API](./extend/README.md).
 
 * **Free and open.** Flarum is released under the [MIT license](https://github.com/flarum/flarum/blob/master/LICENSE).
 

diff --git a/docs/admin.md b/docs/admin.md
@@ -11,5 +11,6 @@ The Admin Dashboard has the following sections, being:
 - **Permissions** - Shows the permissions for each user group, and allows you to configure global and specific scopes.
 - **Appearance** - Allows you to customize the forum's colors, branding and add additional CSS for customization.
 - **Users** - Provides you with a paginated list of all the users in the forum, and grants you the ability to edit the user or take administrative actions.
+- **Advanced** - Allows you to configure advanced settings such as Maintenance Mode, Search drivers, and more.
 
-Apart from the above mentioned sections, the Admin Dashboard also allows you to manage your Extensions (including the flarum core extensions such as Tags) under the _Features_ section. Extensions which modify the forum theme, or allow you to use multiple languages are categorized under the _Themes_ and _Languages_ section respectively.
+Apart from the above-mentioned sections, the Admin Dashboard also allows you to manage your Extensions (including the flarum core extensions such as Tags) under the _Features_ section. Extensions which modify the forum theme, or allow you to use multiple languages are categorized under the _Themes_ and _Languages_ section respectively.
diff --git a/docs/assets/api_flowchart.svg b/docs/assets/api_flowchart.svg
diff --git a/docs/assets/config-repositories.png b/docs/assets/config-repositories.png
diff --git a/docs/assets/extension-manager-page.png b/docs/assets/extension-manager-page.png
diff --git a/docs/assets/extension-manager-queue.png b/docs/assets/extension-manager-queue.png
diff --git a/docs/assets/gambit_autocomplete_dropdown.png b/docs/assets/gambit_autocomplete_dropdown.png
diff --git a/docs/assets/global_search_modal.png b/docs/assets/global_search_modal.png
diff --git a/docs/assets/home_screenshot.png b/docs/assets/home_screenshot.png
diff --git a/docs/assets/install-extension.png b/docs/assets/install-extension.png
diff --git a/docs/assets/uninstall-extension.png b/docs/assets/uninstall-extension.png
diff --git a/docs/assets/update-extension.png b/docs/assets/update-extension.png
diff --git a/docs/bugs.md b/docs/bugs.md
@@ -13,7 +13,7 @@ Thank you for helping us test Flarum. We're happy to have you on the team! We ne
 Found a bug already? Wonderful! We'd love to hear about it &mdash; but first you should check around to make sure you're not wasting your time on a known issue:
 
 - Search our [Support forum](https://discuss.flarum.org/t/support) to see if it's already been reported.
-- We could be working on a fix, so search our [issue tracker](https://github.com/flarum/core/issues) too.
+- We could be working on a fix, so search our [issue tracker](https://github.com/flarum/framework/issues) too.
 
 If you've searched *thoroughly* and come up empty-handed, we'll welcome your report. If it's just a simple issue (a misspelled word or graphics glitch, for example) skip to the next paragraph. But if you're seeing errors, or something is clearly broken, we'll need you to gather some information first. Please head over to our [Troubleshooting](troubleshoot.md) guide and follow the instructions there. Collect as much info as you can!
 

diff --git a/docs/composer.md b/docs/composer.md
@@ -82,7 +82,7 @@ As mentioned above, the entire composer configuration for your Flarum site is co
     // It's a list of packages we want, and the versions for each.
     // We'll discuss this shortly.
     "require": {
-        "flarum/core": "^1.0",
+        "flarum/core": "^2.0",
         "flarum/approval": "*",
         "flarum/bbcode": "*",
         "flarum/emoji": "*",
@@ -120,7 +120,7 @@ To read more about version strings, see the relevant [composer documentation](ht
 
 For Flarum projects, there's several types of entries you'll see in the `require` section of your root install's `flarum/core`:
 
-- You MUST have a `flarum/core` entry. This should have an explicit version string corresponding to the major release you want to install. For Flarum 1.x versions, this would be `^1.0`.
+- You MUST have a `flarum/core` entry. This should have an explicit version string corresponding to the major release you want to install. For Flarum 2.x versions, this would be `^2.0`.
 - You should have an entry for each extension you've installed. Some bundled extensions are included by default (e.g. `flarum/tags`, `flarum/suspend`, etc), [others you'll add via composer commands](extensions.md). Unless you have a reason to do otherwise (e.g. you're testing a beta version of a package), we recommend using an asterisk as the version string for extensions (`*`). This means "install the latest version compatible with my flarum/core".
 - Some extensions / features might require PHP packages that aren't Flarum extensions. For example, you need the guzzle library to use the [Mailgun mail driver](mail.md). In these cases, the instructions for the extension/feature in question should explain which version string to use.
 

diff --git a/docs/config.md b/docs/config.md
@@ -12,10 +12,10 @@ Here's a quick overview of what everything means with an example file:
 ```php
 <?php return array (
   'debug' => false, // enables or disables debug mode, used to troubleshoot issues
-  'offline' => false, // enables or disables site maintenance mode. This makes your site inaccessible to all users (including admins).
+  'offline' => false, // none, high, low or safe.
   'database' =>
   array (
-    'driver' => 'mysql', // the database driver, i.e. MySQL, MariaDB...
+    'driver' => 'mysql', // the database driver, i.e. MySQL, MariaDB, PostgreSQL, SQLite
     'host' => 'localhost', // the host of the connection, localhost in most cases unless using an external service
     'database' => 'flarum', // the name of the database in the instance
     'username' => 'root', // database username
@@ -34,3 +34,15 @@ Here's a quick overview of what everything means with an example file:
   ),
 );
 ```
+
+### Maintenance modes
+
+Flarum has a maintenance mode that can be enabled by setting the `offline` key in the `config.php` file to one of the following values:
+* `none` - No maintenance mode.
+* `high` - No one can access the forum, not even admins.
+* `low` - Only admins can access the forum.
+* `safe` - Only admins can access the forum, and no extensions are booted.
+
+This can also be configured from the admin panel's advanced settings page:
+
+![Toggle advanced page](https://user-images.githubusercontent.com/20267363/277113270-f2e9c91d-2a29-436b-827f-5c4d20e2ed54.png)
diff --git a/docs/contributing.md b/docs/contributing.md
@@ -4,7 +4,7 @@ Interested in contributing to Flarum development? That's great! From [opening a
 
 Before contributing, please read the [code of conduct](code-of-conduct.md).
 
-This document is a guide for developers who want to contribute code to Flarum. If you're just getting started, we recommend that you read the [Getting Started](/extend/start.md) documentation in the Extension docs to understand a bit more about how Flarum works.
+This document is a guide for developers who want to contribute code to Flarum. If you're just getting started, we recommend that you read the [Getting Started](./extend/start.md) documentation in the Extension docs to understand a bit more about how Flarum works.
 
 ## Why Contribute to Flarum?
 
@@ -158,7 +158,7 @@ Flarum's CSS classes roughly follow the [SUIT CSS naming conventions](https://gi
 
 ### Translations
 
-We use a [standard key format](/extend/i18n.md#appendix-a-standard-key-format) to name translation keys descriptively and consistently.
+We use a [standard key format](./extend/i18n.md#appendix-a-standard-key-format) to name translation keys descriptively and consistently.
 
 ## Contributor License Agreement
 
@@ -168,4 +168,4 @@ You confirm that you are able to grant us these rights. You represent that You a
 
 You represent that the Contributions are Your original works of authorship, and to Your knowledge, no other person claims, or has the right to claim, any right in any invention or patent related to the Contributions. You also represent that You are not legally obligated, whether by entering into an agreement or otherwise, in any way that conflicts with the terms of this license.
 
-The Flarum Foundation acknowledges that, except as explicitly described in this Agreement, any Contribution which you provide is on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
+The Flarum Foundation acknowledges that, except as explicitly described in this Agreement, any Contribution which you provide is on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
diff --git a/docs/extend/README.md b/docs/extend/README.md
@@ -30,7 +30,7 @@ If you are aiming to address a bug or shortcoming of the core, or of an existing
 - [Developers explaining their workflow for extension development](https://discuss.flarum.org/d/6320-extension-developers-show-us-your-workflow)
 - [Extension namespace tips](https://discuss.flarum.org/d/9625-flarum-extension-namespacing-tips)
 - [Mithril js documentation](https://mithril.js.org/)
-- [Laravel API Docs](https://laravel.com/api/8.x/)
+- [Laravel API Docs](https://laravel.com/api/11.x/)
 - [Flarum API Docs](https://api.flarum.org)
 - [ES6 cheatsheet](https://github.com/DrkSephy/es6-cheatsheet)