Docs: Extend pages for better findably and readability (#1517)

Author: melroy89

docs/02-admin/03-optional-features/04-user_application.md

@@ -0,0 +1,15 @@
+# Manually Approving New Users
+
+Mbin allows you to manually approve new users before they can log into your server.
+
+If you want to manually approve users before they can log into your server, 
+you can either tick the 'New users have to be approved by an admin before they can log in' checkbox in the admin settings.   
+Or put this in the `.env` file:
+
+```ini
+MBIN_NEW_USERS_NEED_APPROVAL=true
+```
+
+The admin will then see a new 'Signup request' panel in the admin interface where new user registrations will appear pending your approval or denial.
+
+When an administrator approves or denies an user application, the user will receive an email notification about the decision.

docs/02-admin/03-optional-features/04-image_metadata_cleaning.md docs/02-admin/03-optional-features/05-image_metadata_cleaning.md

@@ -7,5 +7,6 @@ Like setting-up:
 - [Mercure](01-mercure.md) - Mercure is used to provide real-time data from the server towards the clients.
 - [Single sign-on (SSO)](02-sso.md) - SSO can be configured to allow registrations via other SSO providers.
 - [Captcha](03-captcha.md) - Captcha protection against spam and anti-bot.
-- [Image metadata cleaning](04-image_metadata_cleaning.md) - Clean-up and remove metadata from images using `exiftool`.
-- [S3 storage](05-s3_storage.md) - Configure an object storage service (S3) compatible bucket for storing images.
+- [User application approval](04-user_application.md) - Manually approve users before they can log into your server (eg. to avoid spam accounts).
+- [Image metadata cleaning](05-image_metadata_cleaning.md) - Clean-up and remove metadata from images using `exiftool`.
+- [S3 storage](06-s3_storage.md) - Configure an object storage service (S3) compatible bucket for storing images.

docs/02-admin/03-optional-features/05-s3_storage.md docs/02-admin/03-optional-features/06-s3_storage.md

@@ -1 +1,11 @@
-# Troubleshooting
+# Troubleshooting
+
+For troubleshooting, see also the [FAQ page we have created](../FAQ.md)!
+
+And to get more (debug) **logging output** see:
+
+- [Bare metal setup troubleshooting page](./01-bare_metal.md)
+
+Or:
+
+- [Docker troubleshooting page](./02-docker.md)

docs/02-admin/03-optional-features/README.md

@@ -152,6 +152,8 @@ _Hint:_ Most messages that are stored in the database are most likely in the `fa
 
 You can find the Mbin logging in the `var/log/` directory from the root folder of the Mbin installation. When running production the file is called `prod-{YYYY-MM-DD}.log`, when running development the log file is called `dev-{YYYY-MM-DD}.log`.
 
+See also [troubleshooting (bare metal)](./05-troubleshooting/01-bare_metal.md).
+
 ## Should I run development mode?
 
 **NO!** Try to avoid running development mode when you are hosting our own _public_ instance. Running in development mode can cause sensitive data to be leaked, such as secret keys or passwords (eg. via development console). Development mode will log a lot of messages to disk (incl. stacktraces).

docs/02-admin/03-optional-features/user_application.md

@@ -2,7 +2,43 @@
 
 Welcome to the admin section of the Mbin documentation.
 
+
+## Installation
+
 You can install Mbin via:
 
 - [Bare metal](01-installation/01-bare_metal.md) (recommended for now)
 - or via [Docker](01-installation/02-docker.md)
+
+## Configuration
+
+- [Mbin configuration files (Symfony)](02-configuration/01-mbin_config_files.md)
+- [Nginx configuration](02-configuration/02-nginx.md)
+- [Let's Encrypt](02-configuration/03-lets_encrypt.md)
+- [PostgreSQL database](02-configuration/04-postgresql.md)
+- [Redis, KeyDB, Valkey cache configuration](02-configuration/05-redis.md)
+
+## Optional features
+
+Optional features like Mercure, SSO, Captcha, Image metadata cleaning or S3 storage:
+
+[More information on the optional features page](./03-optional-features/README.md)
+
+## Running Mbin
+
+- [First setup](04-running-mbin/01-first_setup.md)
+- [Backup](04-running-mbin/02-backup.md)
+- [Upgrades](04-running-mbin/03-upgrades.md)
+- [Symfony messenger](04-running-mbin/04-messenger.md)
+- [Command-line maintenance tool (CLI)](04-running-mbin/05-cli.md)
+
+## Troubleshooting
+
+See [FAQ](FAQ.md). And how-to get logging information see either:
+
+- [Bare metal troubleshooting](05-troubleshooting/01-bare_metal.md)
+- [Docker troubleshooting](05-troubleshooting/02-docker.md)
+
+## FAQ
+
+See [Frequently Asked Questions (FAQ) page](./FAQ.md).

docs/02-admin/05-troubleshooting/bare_metal.md docs/02-admin/05-troubleshooting/01-bare_metal.md

@@ -2,7 +2,7 @@
 
 We split up the documentation for:
 
-- [Users](01-user/README.md) - User guide
+- [End users](01-user/README.md) - End user guide
 - [Admins](02-admin/README.md) - How-to guides for admins
-- [Contributing](03-contributing/README.md) - How to contribute to the project
-- [App developers](04-app_developers/README.md) - How to use Mbin API
+- [Contributing](03-contributing/README.md) - How-to contribute to the Mbin project
+- [App developers](04-app_developers/README.md) - How-to use the Mbin API