diff --git a/i18n/locales/bg/LC_MESSAGES/README.po b/i18n/locales/bg/LC_MESSAGES/README.po
index 9ac7e37f0..10bc599a8 100644
--- a/i18n/locales/bg/LC_MESSAGES/README.po
+++ b/i18n/locales/bg/LC_MESSAGES/README.po
@@ -8,11 +8,11 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: matrix-docker-ansible-deploy \n"
+"Project-Id-Version:  matrix-docker-ansible-deploy\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
+"PO-Revision-Date: 2024-12-20 09:52+0200\n"
+"Last-Translator: \n"
 "Language: bg\n"
 "Language-Team: bg <LL@li.org>\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
@@ -30,10 +30,16 @@ msgid ""
 "docker-ansible-deploy:devture.com) "
 "[![donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/s.pantaleev/donate)"
 msgstr ""
+"[![Matrix стая за поддържка](https://img.shields.io/matrix/matrix-docker-"
+"ansible-deploy:devture.com.svg?label=%23matrix-docker-ansible-"
+"deploy%3Adevture.com&logo=matrix&style=for-the-"
+"badge&server_fqdn=matrix.devture.com)](https://matrix.to/#/#matrix-"
+"docker-ansible-deploy:devture.com) "
+"[![donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/s.pantaleev/donate)"
 
 #: ../../../README.md:1
 msgid "Support room on Matrix"
-msgstr ""
+msgstr "Matrix стая за поддръжка"
 
 #: ../../../README.md:1
 msgid "donate"
@@ -47,14 +53,18 @@ msgstr ""
 
 #: ../../../README.md:5
 msgid "🎯 Purpose"
-msgstr ""
+msgstr "🎯 Цел"
 
 #: ../../../README.md:7
 msgid ""
 "This [Ansible](https://www.ansible.com/) playbook is meant to help you "
 "run your own [Matrix](http://matrix.org/) homeserver, along with the "
 "[various services](#supported-services) related to that."
-msgstr "Този наръчник [Ansible](https://www.ansible.com/) има за цел да ви помогне да стартирате свой собствен [Matrix](http://matrix.org/) домашен сървър, заедно с [различните услуги](#supported-services), свързани с това."
+msgstr ""
+"Този наръчник [Ansible](https://www.ansible.com/) има за цел да ви "
+"помогне да стартирате свой собствен [Matrix](http://matrix.org/) домашен "
+"сървър, заедно с [различните услуги](#supported-services), свързани с "
+"това."
 
 #: ../../../README.md:9
 msgid ""
@@ -110,7 +120,7 @@ msgstr ""
 
 #: ../../../README.md:21
 msgid "🚀 Getting started"
-msgstr ""
+msgstr "🚀 Стартиране"
 
 #: ../../../README.md:23
 msgid ""
@@ -1350,11 +1360,25 @@ msgid ""
 "deploy/issues)"
 msgstr ""
 
-#: ../../../README.md:215
+#: ../../../README.md:201
+msgid "🌐 Translation"
+msgstr ""
+
+#: ../../../README.md:203
+msgid ""
+"See the [i18n/README.md](i18n/README.md) file for more information about "
+"translation."
+msgstr ""
+
+#: ../../../README.md:205
+msgid "Translations are still work in progress."
+msgstr ""
+
+#: ../../../README.md:207
 msgid "🤝 Related"
 msgstr ""
 
-#: ../../../README.md:217
+#: ../../../README.md:209
 msgid ""
 "You may also be interested in [mash-playbook](https://github.com/mother-"
 "of-all-self-hosting/mash-playbook) - another Ansible playbook for self-"
@@ -1363,7 +1387,7 @@ msgid ""
 "playbook/blob/main/docs/supported-services.md))."
 msgstr ""
 
-#: ../../../README.md:219
+#: ../../../README.md:211
 msgid ""
 "mash-playbook also makes use of [Traefik](./docs/configuring-playbook-"
 "traefik.md) as its reverse-proxy, so with minor [interoperability "
@@ -1372,3 +1396,4 @@ msgid ""
 "ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix "
 "services on the same server."
 msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
index 6aa45c304..b66d0461a 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -41,19 +41,12 @@ msgstr ""
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:5
 msgid ""
 "See the project's [documentation](https://github.com/metio/matrix-"
-"alertmanager-receiver) to learn more about what this component does and "
-"why it might be useful to you."
+"alertmanager-receiver/blob/main/README.md) to learn what it does and why "
+"it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:7
 msgid ""
-"At the moment, **setting up this service's bot requires some manual "
-"actions** as described below in [Account and room preparation](#account-"
-"and-room-preparation)."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9
-msgid ""
 "This service is meant to be used with an external "
 "[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) "
 "instance. It's **not** meant to be integrated with the [Prometheus & "
@@ -62,27 +55,93 @@ msgid ""
 "it."
 msgstr ""
 
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9
+msgid "Prerequisites"
+msgstr ""
+
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:11
-msgid "Adjusting the playbook configuration"
+msgid "Register the bot account"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:13
 msgid ""
-"To enable matrix-alertmanager-receiver, add the following configuration "
-"to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
+"This service uses a bot (with a username specified in "
+"`matrix_alertmanager_receiver_config_matrix_user_id_localpart`) for "
+"delivering messages."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:36
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:15
+msgid ""
+"The playbook does not automatically create users for you. You **need to "
+"register the bot user manually** before setting up the bot."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:17
+msgid ""
+"Choose a strong password for the bot. You can generate a good password "
+"with a command like this: `pwgen -s 64 1`."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:19
+msgid "You can use the playbook to [register a new user](registering-users.md):"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:25
+msgid "Get an access token"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:27
+msgid ""
+"The bot requires an access token to be able to connect to your "
+"homeserver. Refer to the documentation on [how to obtain an access token"
+"](obtaining-access-tokens.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:29
+msgid "Join to rooms as the bot manually"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:31
+msgid ""
+"ℹ️ **This bot does not accept room invitations automatically**. To "
+"deliver messages to rooms, the bot must be joined to all rooms manually."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:33
+msgid ""
+"For each new room you would like the bot to deliver alerts to, invite the"
+" bot to the room."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:35
+msgid ""
+"Then, log in as the bot using any Matrix client of your choosing, accept "
+"the room invitation from the bot's account, and log out."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:37
+msgid "Adjusting the playbook configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:39
+msgid ""
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
+"token)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:61
 msgid ""
 "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for "
 "additional configuration variables."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:38
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63
 msgid "Adjusting the matrix-alertmanager-receiver URL"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:40
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:65
 msgid ""
 "By default, this playbook installs matrix-alertmanager-receiver on the "
 "`matrix.` subdomain, at the `/matrix-alertmanager-receiver` path "
@@ -91,7 +150,7 @@ msgid ""
 "to be set up**. If that's okay, you can skip this section."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:42
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67
 msgid ""
 "By tweaking the `matrix_alertmanager_receiver_hostname` and "
 "`matrix_alertmanager_receiver_path_prefix` variables, you can easily make"
@@ -99,125 +158,61 @@ msgid ""
 "default one."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:44
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69
 msgid ""
 "Example additional configuration for your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:52
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77
 msgid "Adjusting DNS records"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:54
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:79
 msgid ""
 "If you've changed the default hostname, **you may need to adjust your "
 "DNS** records to point the matrix-alertmanager-receiver domain to the "
 "Matrix server."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:56
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:81
 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:58
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:83
 msgid ""
 "If you've decided to use the default hostname, you won't need to do any "
 "extra DNS configuration."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:60
-msgid "Account and room preparation"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62
-msgid ""
-"The playbook can automatically create users, but it cannot automatically "
-"obtain access tokens, nor perform any of the other manual actions below."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64
-msgid ""
-"`matrix-alertmanager-receiver` uses a bot (with a username specified in "
-"`matrix_alertmanager_receiver_config_matrix_user_id_localpart` - see "
-"above) for delivering messages. You need to **manually register this bot "
-"acccount and obtain an access token for it**."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66
-msgid ""
-"[Register a new user](registering-users.md): `ansible-playbook -i "
-"inventory/hosts setup.yml --extra-"
-"vars='username=bot.alertmanager.receiver password=PASSWORD_FOR_THE_BOT "
-"admin=no' --tags=register-user`"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67
-msgid ""
-"[Obtain an access token](obtaining-access-tokens.md) for the bot's user "
-"account"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68
-msgid "Invite the bot to a room where you'd like to alerts to be delivered"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69
-msgid ""
-"Log in as the bot using any Matrix client of your choosing, accept the "
-"room invitation from the bot's account and log out"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:70
-msgid ""
-"(Optionally) Adjust "
-"`matrix_alertmanager_receiver_config_matrix_room_mapping` to create a "
-"mapping between the new room and its ID"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:72
-msgid ""
-"Steps 1 and 2 above only need to be done once, while preparing your "
-"[configuration](#adjusting-the-playbook-configuration)."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:74
-msgid ""
-"Steps 3 and 4 need to be done for each new room you'd like the bot to "
-"deliver alerts to. Step 5 is optional and provides cleaner `/alert/` "
-"URLs."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:76
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87
 msgid ""
-"Now that you've [prepared the bot account and room](#account-and-room-"
-"preparation), [configured the playbook](#adjusting-the-playbook-"
-"configuration), and potentially [adjusted your DNS records](#adjusting-"
-"dns-records), you can run the playbook with [playbook tags](playbook-"
-"tags.md) as below:"
+"After configuring the playbook and potentially [adjusting your DNS "
+"records](#adjusting-dns-records), run the playbook with [playbook tags"
+"](playbook-tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:94
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:96
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:89
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:98
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:91
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:100
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -226,27 +221,136 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:93
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:104
 msgid "Configure your Prometheus Alertmanager with configuration like this:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:114
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123
 msgid ""
-".. where `URL_HERE` looks like `https://matrix.example.com/matrix-"
+"where `URL_HERE` looks like `https://matrix.example.com/matrix-"
 "alertmanager-receiver-RANDOM_VALUE_HERE/alert/some-room-name` or "
 "`https://matrix.example.com/matrix-alertmanager-receiver-"
 "RANDOM_VALUE_HERE/alert/!qporfwt:example.com`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:116
-msgid ""
-"This bot does **not** accept room invitations automatically (like many "
-"other bots do). To deliver messages to rooms, **the bot must be joined to"
-" all rooms manually** - see Step 4 of the [Account and room preparation"
-"](#account-and-room-preparation) section."
-msgstr ""
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/metio/matrix-alertmanager-"
+#~ "receiver) to learn more about what "
+#~ "this component does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "At the moment, **setting up this "
+#~ "service's bot requires some manual "
+#~ "actions** as described below in [Account"
+#~ " and room preparation](#account-and-"
+#~ "room-preparation)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "To enable matrix-alertmanager-receiver, "
+#~ "add the following configuration to your"
+#~ " `inventory/host_vars/matrix.example.com/vars.yml` file:"
+#~ msgstr ""
+
+#~ msgid "Account and room preparation"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The playbook can automatically create "
+#~ "users, but it cannot automatically "
+#~ "obtain access tokens, nor perform any"
+#~ " of the other manual actions below."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "`matrix-alertmanager-receiver` uses a "
+#~ "bot (with a username specified in "
+#~ "`matrix_alertmanager_receiver_config_matrix_user_id_localpart` -"
+#~ " see above) for delivering messages. "
+#~ "You need to **manually register this "
+#~ "bot acccount and obtain an access "
+#~ "token for it**."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "[Register a new user](registering-users.md):"
+#~ " `ansible-playbook -i inventory/hosts "
+#~ "setup.yml --extra-vars='username=bot.alertmanager.receiver"
+#~ " password=PASSWORD_FOR_THE_BOT admin=no' --tags"
+#~ "=register-user`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "[Obtain an access token](obtaining-access-"
+#~ "tokens.md) for the bot's user account"
+#~ msgstr ""
+
+#~ msgid "Invite the bot to a room where you'd like to alerts to be delivered"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Log in as the bot using any "
+#~ "Matrix client of your choosing, accept"
+#~ " the room invitation from the bot's"
+#~ " account and log out"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "(Optionally) Adjust "
+#~ "`matrix_alertmanager_receiver_config_matrix_room_mapping` to "
+#~ "create a mapping between the new "
+#~ "room and its ID"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Steps 1 and 2 above only need "
+#~ "to be done once, while preparing "
+#~ "your [configuration](#adjusting-the-playbook-"
+#~ "configuration)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Steps 3 and 4 need to be "
+#~ "done for each new room you'd like"
+#~ " the bot to deliver alerts to. "
+#~ "Step 5 is optional and provides "
+#~ "cleaner `/alert/` URLs."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Now that you've [prepared the bot "
+#~ "account and room](#account-and-room-"
+#~ "preparation), [configured the playbook"
+#~ "](#adjusting-the-playbook-configuration), and "
+#~ "potentially [adjusted your DNS records"
+#~ "](#adjusting-dns-records), you can run "
+#~ "the playbook with [playbook tags](playbook-"
+#~ "tags.md) as below:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ ".. where `URL_HERE` looks like "
+#~ "`https://matrix.example.com/matrix-alertmanager-"
+#~ "receiver-RANDOM_VALUE_HERE/alert/some-room-name` "
+#~ "or `https://matrix.example.com/matrix-alertmanager-"
+#~ "receiver-RANDOM_VALUE_HERE/alert/!qporfwt:example.com`."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "This bot does **not** accept room "
+#~ "invitations automatically (like many other "
+#~ "bots do). To deliver messages to "
+#~ "rooms, **the bot must be joined to"
+#~ " all rooms manually** - see Step "
+#~ "4 of the [Account and room "
+#~ "preparation](#account-and-room-preparation) "
+#~ "section."
+#~ msgstr ""
 
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po
index 6e1b9782e..e993b61b9 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -84,27 +84,31 @@ msgid ""
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19
-msgid "Installation"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:21
-msgid "Create a main management room."
+msgid "Create a main management room"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:23
 msgid ""
 "The playbook does not create a management room for your Main Draupnir. "
-"This task you have to do on your own."
+"You **need to create the room manually** before setting up the bot."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
+msgid "Note that the room must be unencrypted."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
 msgid ""
 "The management room has to be given an alias and be public when you are "
 "setting up the bot for the first time as the bot does not differentiate "
 "between invites and invites to the management room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:27
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:31
 msgid ""
 "This management room is used to control who has access to your D4A "
 "deployment. The room stores this data inside of the control room state so"
@@ -112,77 +116,107 @@ msgid ""
 "This is default 50 or moderator as Element clients call this powerlevel."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33
 msgid ""
 "As noted in the Draupnir install instructions the control room is "
-"sensitive. The following is said about the control room in the Draupnir "
-"install instructions."
+"sensitive. **Anyone in this room can control the bot so it is important "
+"that you only invite trusted users to this room.**"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:30
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:35
+msgid "Set an alias to the management room"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:37
+msgid "Next, set an alias to the management room."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39
 msgid ""
-"Anyone in this room can control the bot so it is important that you only "
-"invite trusted users to this room. The room must be unencrypted since the"
-" playbook does not support installing Pantalaimon yet."
+"This alias can be anything you want. However, for increased security "
+"during the setup phase, it is recommended to make this alias be a random "
+"string. When it has been locked down after setup phase, you can give your"
+" room a secondary human readable alias."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:32
-msgid "Give your main management room an alias."
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:41
+msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:34
-msgid ""
-"Give the room from step 1 an alias. This alias can be anything you want "
-"and its recommended for increased security during the setup phase of the "
-"bot that you make this alias be a random string. You can give your room a"
-" secondary human readable alias when it has been locked down after setup "
-"phase."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:36
-msgid "Adjusting the playbook configuration."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:38
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:43
 msgid ""
 "Add the following configuration to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
-"needs):"
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `MANAGEMENT_ROOM_ALIAS_HERE`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:40
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:51
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53
 msgid ""
-"You must replace `ALIAS_FROM_STEP_2_GOES_HERE` with the alias you created"
-" in step 2."
+"You can configure additional options by adding the "
+"`matrix_appservice_draupnir_for_all_extension_yaml` variable."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:48
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:55
+msgid ""
+"For example, to change Draupnir's `protectAllJoinedRooms` option to "
+"`true`, add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
+msgid ""
+"You can refer to the upstream [documentation](https://github.com/the-"
+"draupnir-project/Draupnir) for more configuration documentation."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:86
+msgid "**Notes**:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
+msgid ""
+"The playbook ships a full copy of the example config that does transfer "
+"to provisioned Draupnirs in the production-bots.yaml.j2 file in the "
+"template directory of the role."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
+msgid ""
+"Config extension does not affect the appservices config as this config is"
+" not extensible in current Draupnir anyway. It instead touches the config"
+" passed to the Draupnirs that your Appservice creates. So the example "
+"above (`protectAllJoinedRooms: true`) makes all provisioned Draupnirs "
+"protect all joined rooms."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:50
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:57
-msgid "**Notes**:"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:59
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:88
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:61
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:90
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:63
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:92
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -191,29 +225,29 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:65
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:67
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:96
 msgid ""
 "If you made it through all the steps above and your main control room was"
 " joined by a user called `@draupnir-main:example.com` you have "
 "succesfully installed Draupnir for All and can now start using it."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:98
 msgid ""
 "The installation of Draupnir for all in this playbook is very much Alpha "
-"quality. Usage-wise, Draupnir for allis almost identical to Draupnir bot "
-"mode."
+"quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot"
+" mode."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100
 msgid "Granting Users the ability to use D4A"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:102
 msgid ""
 "Draupnir for all includes several security measures like that it only "
 "allows users that are on its allow list to ask for a bot. To add a user "
@@ -224,7 +258,7 @@ msgid ""
 " the chat is recomended."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:104
 msgid ""
 "The bot requires a powerlevel of 50 in the management room to control who"
 " is allowed to use the bot. The bot does currently not say anything if "
@@ -233,7 +267,7 @@ msgid ""
 "project/Draupnir/issues/297))"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:106
 msgid ""
 "To allow users or whole homeservers you type /plain @draupnir-"
 "main:example.com allow `target` and target can be either a MXID or a "
@@ -242,57 +276,146 @@ msgid ""
 "this command as it can break Wildcard commands especially."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
-msgid "How to provision a D4A once you are allowed to."
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108
+msgid "How to provision a D4A once you are allowed to"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:81
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110
 msgid ""
-"Open a DM with @draupnir-main:example.com and if using an Element client "
-"send a message into this DM to finalise creating it. The bot will reject "
-"this invite and you will shortly get invited to the Draupnir control room"
-" for your newly provisioned Draupnir. From here its just a normal "
-"Draupnir experience."
+"To provision a D4A, you need to start a chat with `@draupnir-"
+"main:example.com`. The bot will reject this invite and you will shortly "
+"get invited to the Draupnir control room for your newly provisioned "
+"Draupnir. From here its just a normal Draupnir experience."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:83
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:112
 msgid ""
 "Congratulations if you made it all the way here because you now have a "
 "fully working Draupnir for all deployment."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:85
-msgid "Configuration of D4A"
-msgstr ""
+#~ msgid "Installation"
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:87
-msgid ""
-"You can refer to the upstream [documentation](https://github.com/the-"
-"draupnir-project/Draupnir) for more configuration documentation. Please "
-"note that the playbook ships a full copy of the example config that does "
-"transfer to provisioned Draupnirs in the production-bots.yaml.j2 file in "
-"the template directory of the role."
-msgstr ""
+#~ msgid "Create a main management room."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:89
-msgid ""
-"Please note that Config extension does not affect the appservices config "
-"as this config is not extensible in current Draupnir anyways. Config "
-"extension instead touches the config passed to the Draupnirs that your "
-"Appservice creates. So for example below makes all provisioned Draupnirs "
-"protect all joined rooms."
-msgstr ""
+#~ msgid ""
+#~ "The playbook does not create a "
+#~ "management room for your Main Draupnir."
+#~ " This task you have to do on"
+#~ " your own."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:91
-msgid ""
-"You can configure additional options by adding the "
-"`matrix_appservice_draupnir_for_all_extension_yaml` variable to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "As noted in the Draupnir install "
+#~ "instructions the control room is "
+#~ "sensitive. The following is said about"
+#~ " the control room in the Draupnir "
+#~ "install instructions."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:93
-msgid ""
-"For example to change Draupnir's `protectAllJoinedRooms` option to `true`"
-" you would add the following to your `vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "Anyone in this room can control "
+#~ "the bot so it is important that"
+#~ " you only invite trusted users to "
+#~ "this room. The room must be "
+#~ "unencrypted since the playbook does not"
+#~ " support installing Pantalaimon yet."
+#~ msgstr ""
+
+#~ msgid "Give your main management room an alias."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Give the room from step 1 an "
+#~ "alias. This alias can be anything "
+#~ "you want and its recommended for "
+#~ "increased security during the setup "
+#~ "phase of the bot that you make "
+#~ "this alias be a random string. You"
+#~ " can give your room a secondary "
+#~ "human readable alias when it has "
+#~ "been locked down after setup phase."
+#~ msgstr ""
+
+#~ msgid "Adjusting the playbook configuration."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Add the following configuration to your"
+#~ " `inventory/host_vars/matrix.example.com/vars.yml` file "
+#~ "(adapt to your needs):"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` "
+#~ "with the alias you created in step"
+#~ " 2."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The installation of Draupnir for all "
+#~ "in this playbook is very much "
+#~ "Alpha quality. Usage-wise, Draupnir for"
+#~ " allis almost identical to Draupnir "
+#~ "bot mode."
+#~ msgstr ""
+
+#~ msgid "How to provision a D4A once you are allowed to."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Open a DM with @draupnir-"
+#~ "main:example.com and if using an Element"
+#~ " client send a message into this "
+#~ "DM to finalise creating it. The "
+#~ "bot will reject this invite and "
+#~ "you will shortly get invited to "
+#~ "the Draupnir control room for your "
+#~ "newly provisioned Draupnir. From here "
+#~ "its just a normal Draupnir experience."
+#~ msgstr ""
+
+#~ msgid "Configuration of D4A"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can refer to the upstream "
+#~ "[documentation](https://github.com/the-draupnir-"
+#~ "project/Draupnir) for more configuration "
+#~ "documentation. Please note that the "
+#~ "playbook ships a full copy of the"
+#~ " example config that does transfer to"
+#~ " provisioned Draupnirs in the "
+#~ "production-bots.yaml.j2 file in the "
+#~ "template directory of the role."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Please note that Config extension does"
+#~ " not affect the appservices config as"
+#~ " this config is not extensible in "
+#~ "current Draupnir anyways. Config extension "
+#~ "instead touches the config passed to "
+#~ "the Draupnirs that your Appservice "
+#~ "creates. So for example below makes "
+#~ "all provisioned Draupnirs protect all "
+#~ "joined rooms."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can configure additional options by"
+#~ " adding the "
+#~ "`matrix_appservice_draupnir_for_all_extension_yaml` variable "
+#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
+#~ " file."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For example to change Draupnir's "
+#~ "`protectAllJoinedRooms` option to `true` you"
+#~ " would add the following to your "
+#~ "`vars.yml` file."
+#~ msgstr ""
 
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
index 0cd924e1d..2b5dc52fe 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -34,8 +34,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-draupnir.md:5
 msgid ""
 "See the project's [documentation](https://github.com/the-draupnir-"
-"project/Draupnir) to learn what it does and why it might be useful to "
-"you."
+"project/Draupnir/blob/main/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:7
@@ -47,21 +47,23 @@ msgid ""
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:9
-msgid "If your migrating from Mjolnir skip to step 5b."
+msgid ""
+"If your migrating from Mjolnir skip to [this section](#migrating-from-"
+"mjolnir-only-required-if-migrating)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:11
-msgid "Register the bot account"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:13
-msgid ""
-"The playbook does not automatically create users for you. The bot "
-"requires an access token to be able to connect to your homeserver."
+msgid "Register the bot account"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:15
-msgid "You **need to register the bot user manually** before setting up the bot."
+msgid ""
+"The playbook does not automatically create users for you. You **need to "
+"register the bot user manually** before setting up the bot."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:17
@@ -77,7 +79,7 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-draupnir.md:25
 msgid ""
 "If you would like Draupnir to be able to deactivate users, move aliases, "
-"shutdown rooms, show abuse reports ([see below](#abuse-reports)), etc "
+"shutdown rooms, show abuse reports (see [below](#abuse-reports)), etc "
 "then it must be a server admin so you need to change `admin=no` to "
 "`admin=yes` in the command above."
 msgstr ""
@@ -88,8 +90,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:29
 msgid ""
-"Refer to the documentation on [how to obtain an access token](obtaining-"
-"access-tokens.md)."
+"The bot requires an access token to be able to connect to your "
+"homeserver. Refer to the documentation on [how to obtain an access token"
+"](obtaining-access-tokens.md)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:31
@@ -98,43 +101,65 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:33
 msgid ""
-"You will need to prevent Synapse from rate limiting the bot's account. "
-"This is not an optional step. If you do not do this step Draupnir will "
-"crash. This can be done using Synapse's [admin API](https://matrix-"
-"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
-"ratelimiting-for-users). Please ask for help if you are uncomfortable "
-"with these steps or run into issues."
+"If your homeserver's implementation is Synapse, you will need to prevent "
+"it from rate limiting the bot's account. **This is a required step. If "
+"you do not configure it, Draupnir will crash.**"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:35
 msgid ""
-"If your Synapse Admin API is exposed to the internet for some reason like"
-" running the Synapse Admin Role [Link](configuring-playbook-synapse-"
-"admin.md) or running "
-"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
-" true` in your playbook config. If your API is not externally exposed you"
-" should still be able to on the local host for your synapse run these "
-"commands."
+"This can be done using Synapse's [Admin APIs](https://element-"
+"hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
+"ratelimiting-for-users). They can be accessed both externally and "
+"internally."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:37
 msgid ""
-"The following command works on semi up to date Windows 10 installs and "
-"All Windows 11 installations and other systems that ship curl. `curl "
-"--header \"Authorization: Bearer <access_token>\" -X POST "
-"https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`"
-" Replace `@bot.draupnir:example.com` with the MXID of your Draupnir and "
-"example.com with your homeserver domain. You can easily obtain an access "
-"token for a homeserver admin account the same way you can obtain an "
-"access token for Draupnir itself. If you made Draupnir Admin you can just"
-" use the Draupnir token."
+"To expose the APIs publicly, add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:39
+#: ../../../docs/configuring-playbook-bot-draupnir.md:43
+msgid ""
+"The APIs can also be accessed via [Synapse "
+"Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can "
+"use to administrate users, rooms, media, etc. on your Matrix server. The "
+"playbook can install and configure Synapse Admin for you. For details "
+"about it, see [this page](configuring-playbook-synapse-admin.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:45
+msgid ""
+"**Note**: access to the APIs is restricted with a valid access token, so "
+"exposing them publicly should not be a real security concern. Still, "
+"doing so is not recommended for additional security. See [official "
+"Synapse reverse-proxying recommendations](https://element-"
+"hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
+"endpoints)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:47
+msgid ""
+"To discharge rate limiting, run the following command on systems that "
+"ship curl (note that it does not work on outdated Windows 10). Even if "
+"the APIs are not exposed to the internet, you should still be able to run"
+" the command on the homeserver locally. Before running it, make sure to "
+"replace `@bot.draupnir:example.com` with the MXID of your Draupnir:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:53
+msgid ""
+"You can obtain an access token for a homeserver admin account in the same"
+" way as you can do so for Draupnir itself. If you have made Draupnir an "
+"admin, you can just use the Draupnir token."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:55
 msgid "Create a management room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:41
+#: ../../../docs/configuring-playbook-bot-draupnir.md:57
 msgid ""
 "Using your own account, create a new invite only room that you will use "
 "to manage the bot. This is the room where you will see the status of the "
@@ -143,13 +168,13 @@ msgid ""
 "it is important that you only invite trusted users to this room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:43
+#: ../../../docs/configuring-playbook-bot-draupnir.md:59
 msgid ""
 "If you make the management room encrypted (E2EE), then you MUST enable "
-"and use Pantalaimon (see below)."
+"and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:45
+#: ../../../docs/configuring-playbook-bot-draupnir.md:61
 msgid ""
 "Once you have created the room you need to copy the room ID so you can "
 "tell the bot to use that room. In Element Web you can do this by going to"
@@ -157,43 +182,58 @@ msgid ""
 "room ID. The room ID will look something like `!qporfwt:example.com`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:47
+#: ../../../docs/configuring-playbook-bot-draupnir.md:63
 msgid ""
 "Finally invite the `@bot.draupnir:example.com` account you created "
 "earlier into the room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:49
+#: ../../../docs/configuring-playbook-bot-draupnir.md:65
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:51
+#: ../../../docs/configuring-playbook-bot-draupnir.md:67
+msgid ""
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `MANAGEMENT_ROOM_ID_HERE`."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:76
+msgid "End-to-End Encryption support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:78
 msgid ""
 "Decide whether you want Draupnir to be capable of operating in end-to-end"
 " encrypted (E2EE) rooms. This includes the management room and the "
-"moderated rooms. To support E2EE, Draupnir needs to [use Pantalaimon"
-"](configuring-playbook-pantalaimon.md)."
+"moderated rooms."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:53
-msgid "a. Configuration with E2EE support"
+#: ../../../docs/configuring-playbook-bot-draupnir.md:80
+msgid ""
+"To support E2EE, Draupnir needs to [use Pantalaimon](configuring-"
+"playbook-pantalaimon.md)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:55
+#: ../../../docs/configuring-playbook-bot-draupnir.md:82
+msgid "Configuration with E2EE support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:84
 msgid ""
 "When using Pantalaimon, Draupnir will log in to its bot account itself "
 "through Pantalaimon, so configure its username and password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:57
-#: ../../../docs/configuring-playbook-bot-draupnir.md:92
+#: ../../../docs/configuring-playbook-bot-draupnir.md:86
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:76
+#: ../../../docs/configuring-playbook-bot-draupnir.md:100
 msgid ""
 "The playbook's `group_vars` will configure other required settings. If "
 "using this role separately without the playbook, you also need to "
@@ -202,65 +242,108 @@ msgid ""
 "playbook's `group_vars`:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:88
-msgid "b. Configuration without E2EE support"
+#: ../../../docs/configuring-playbook-bot-draupnir.md:112
+msgid "Configuration without E2EE support"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:90
+#: ../../../docs/configuring-playbook-bot-draupnir.md:114
 msgid ""
 "When NOT using Pantalaimon, Draupnir does not log in by itself and you "
 "must give it an access token for its bot account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:94
+#: ../../../docs/configuring-playbook-bot-draupnir.md:116
 msgid ""
-"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
-"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values."
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
+"token)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:104
-msgid "c. Migrating from Mjolnir (Only required if migrating.)"
+#: ../../../docs/configuring-playbook-bot-draupnir.md:122
+msgid "Abuse Reports"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:106
+#: ../../../docs/configuring-playbook-bot-draupnir.md:124
+msgid "Draupnir supports two methods to receive reports in the management room."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:126
+msgid ""
+"The first method intercepts the report API endpoint of the client-server "
+"API, which requires integration with the reverse proxy in front of the "
+"homeserver. If you are using traefik, this playbook can set this up for "
+"you:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:132
+msgid ""
+"The other method polls an Synapse Admin API endpoint, hence it is "
+"available only if using Synapse and if the Draupnir user is an admin (see"
+" [above](#register-the-bot-account)). To enable it, set `pollReports: "
+"true` on `vars.yml` file as below."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:134
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:136
+msgid ""
+"You can configure additional options by adding the "
+"`matrix_bot_draupnir_configuration_extension_yaml` variable."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:138
+msgid ""
+"For example, to change Draupnir's `pollReports` option to `true`, add the"
+" following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:152
+msgid "Migrating from Mjolnir (Only required if migrating)"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:154
 msgid ""
 "Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` "
 "config. Also disable Mjolnir if you're doing migration."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:108
+#: ../../../docs/configuring-playbook-bot-draupnir.md:156
 msgid ""
 "That is all you need to do due to that Draupnir can complete migration on"
 " its own."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:110
+#: ../../../docs/configuring-playbook-bot-draupnir.md:158
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:112
+#: ../../../docs/configuring-playbook-bot-draupnir.md:160
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:119
+#: ../../../docs/configuring-playbook-bot-draupnir.md:167
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:121
+#: ../../../docs/configuring-playbook-bot-draupnir.md:169
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:123
+#: ../../../docs/configuring-playbook-bot-draupnir.md:171
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:125
+#: ../../../docs/configuring-playbook-bot-draupnir.md:173
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -269,7 +352,7 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:127
+#: ../../../docs/configuring-playbook-bot-draupnir.md:175
 msgid ""
 "If you change the Pantalaimon's password "
 "(`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) "
@@ -280,32 +363,32 @@ msgid ""
 " know its new password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:129
+#: ../../../docs/configuring-playbook-bot-draupnir.md:177
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:131
+#: ../../../docs/configuring-playbook-bot-draupnir.md:179
 msgid ""
 "You can refer to the upstream [documentation](https://the-draupnir-"
 "project.github.io/draupnir-documentation/) for additional ways to use and"
 " configure Draupnir and for a more detailed usage guide."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:133
+#: ../../../docs/configuring-playbook-bot-draupnir.md:181
 msgid "Below is a **non-exhaustive quick-start guide** for the impatient."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:135
+#: ../../../docs/configuring-playbook-bot-draupnir.md:183
 msgid "Making Draupnir join and protect a room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:137
+#: ../../../docs/configuring-playbook-bot-draupnir.md:185
 msgid ""
 "Draupnir can be told to self-join public rooms, but it's better to follow"
 " this flow which works well for all kinds of rooms:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:139
+#: ../../../docs/configuring-playbook-bot-draupnir.md:187
 msgid ""
 "Invite the bot to the room manually ([inviting Draupnir to rooms](https"
 "://the-draupnir-project.github.io/draupnir-documentation/moderator"
@@ -313,13 +396,13 @@ msgid ""
 "the bot *may* ask for confirmation in the Management Room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:141
+#: ../../../docs/configuring-playbook-bot-draupnir.md:189
 msgid ""
 "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-"
 "do-its-job)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:143
+#: ../../../docs/configuring-playbook-bot-draupnir.md:191
 msgid ""
 "Tell it to protect the room (using the [rooms command](https://the-"
 "draupnir-project.github.io/draupnir-documentation/moderator/managing-"
@@ -328,7 +411,7 @@ msgid ""
 "!qporfwt:example.com`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:145
+#: ../../../docs/configuring-playbook-bot-draupnir.md:193
 msgid ""
 "To have Draupnir provide useful room protection, you need do to a bit "
 "more work (at least the first time around). You may wish to [Subscribe to"
@@ -337,11 +420,11 @@ msgid ""
 " and [Enabling built-in protections](#enabling-built-in-protections)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:147
+#: ../../../docs/configuring-playbook-bot-draupnir.md:195
 msgid "Giving Draupnir permissions to do its job"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:149
+#: ../../../docs/configuring-playbook-bot-draupnir.md:197
 msgid ""
 "For Draupnir to do its job, you need to [give it permissions](https"
 "://the-draupnir-project.github.io/draupnir-documentation/moderator"
@@ -349,7 +432,7 @@ msgid ""
 "protecting. This involves **giving it an Administrator power level**."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:151
+#: ../../../docs/configuring-playbook-bot-draupnir.md:199
 msgid ""
 "**We recommend setting this power level as soon as the bot joins your "
 "room** (and before you create new rules), so that it can apply rules as "
@@ -358,11 +441,11 @@ msgid ""
 " it)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:153
+#: ../../../docs/configuring-playbook-bot-draupnir.md:201
 msgid "Subscribing to a public policy list"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:155
+#: ../../../docs/configuring-playbook-bot-draupnir.md:203
 msgid ""
 "We recommend **subscribing to a public [policy list](https://the-"
 "draupnir-project.github.io/draupnir-documentation/concepts/policy-"
@@ -371,24 +454,24 @@ msgid ""
 "watch-command-to-subscribe-to-policy-rooms)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:157
+#: ../../../docs/configuring-playbook-bot-draupnir.md:205
 msgid ""
 "Polcy lists are maintained in Matrix rooms. A popular policy list is "
 "maintained in the public `#community-moderation-effort-bl:neko.dev` room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:159
+#: ../../../docs/configuring-playbook-bot-draupnir.md:207
 msgid ""
 "You can tell Draupnir to subscribe to it by sending the following command"
 " to the Management Room: `!draupnir watch #community-moderation-effort-"
 "bl:neko.dev`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:161
+#: ../../../docs/configuring-playbook-bot-draupnir.md:209
 msgid "Creating your own policy lists and rules"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:163
+#: ../../../docs/configuring-playbook-bot-draupnir.md:211
 msgid ""
 "We also recommend **creating your own policy lists** with the [list "
 "create](https://the-draupnir-project.github.io/draupnir-"
@@ -396,7 +479,7 @@ msgid ""
 "create-command-to-create-a-policy-room) command."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:165
+#: ../../../docs/configuring-playbook-bot-draupnir.md:213
 msgid ""
 "You can do so by sending the following command to the Management Room: "
 "`!draupnir list create my-bans my-bans-bl`. This will create a policy "
@@ -405,7 +488,7 @@ msgid ""
 "command, the bot will invite you to the policy list room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:167
+#: ../../../docs/configuring-playbook-bot-draupnir.md:215
 msgid ""
 "A policy list does nothing by itself, so the next step is **adding some "
 "rules to your policy list**. Policies target a so-called `entity` (one "
@@ -416,7 +499,7 @@ msgid ""
 "recommendation)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:169
+#: ../../../docs/configuring-playbook-bot-draupnir.md:217
 msgid ""
 "The simplest and most useful entity to target is `user`. Below are a few "
 "examples using the [ban command](https://the-draupnir-project.github.io"
@@ -424,19 +507,19 @@ msgid ""
 "targeting users."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:171
+#: ../../../docs/configuring-playbook-bot-draupnir.md:219
 msgid ""
 "To create rules, you run commands in the Management Room (**not** in the "
 "policy list room)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:173
+#: ../../../docs/configuring-playbook-bot-draupnir.md:221
 msgid ""
 "(ban a single user on a given homeserver): `!draupnir ban "
 "@charles:example.com my-bans Rude to others`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:174
+#: ../../../docs/configuring-playbook-bot-draupnir.md:222
 msgid ""
 "(ban all users on a given homeserver by using a [wildcard](https://the-"
 "draupnir-project.github.io/draupnir-documentation/moderator/managing-"
@@ -444,34 +527,34 @@ msgid ""
 "all users are fake`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:176
+#: ../../../docs/configuring-playbook-bot-draupnir.md:224
 msgid "As a result of running these commands, you may observe:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:178
+#: ../../../docs/configuring-playbook-bot-draupnir.md:226
 msgid ""
 "Draupnir creating `m.policy.rule.user` state events in the `#my-bans-"
 "bl:example.com` room on your server"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:179
+#: ../../../docs/configuring-playbook-bot-draupnir.md:227
 msgid ""
 "applying these rules against all rooms that Draupnir is an Administrator "
 "in"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:181
+#: ../../../docs/configuring-playbook-bot-draupnir.md:229
 msgid ""
 "You can undo bans with the [unban command](https://the-draupnir-"
 "project.github.io/draupnir-documentation/moderator/managing-users#the-"
 "unban-command)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:183
+#: ../../../docs/configuring-playbook-bot-draupnir.md:231
 msgid "Enabling built-in protections"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:185
+#: ../../../docs/configuring-playbook-bot-draupnir.md:233
 msgid ""
 "You can also **turn on various built-in [protections](https://the-"
 "draupnir-project.github.io/draupnir-documentation/protections)** like "
@@ -479,75 +562,179 @@ msgid ""
 "room to invite-only\")."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:187
+#: ../../../docs/configuring-playbook-bot-draupnir.md:235
 msgid ""
 "To **see which protections are available and which are enabled**, send a "
 "`!draupnir protections` command to the Management Room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:189
+#: ../../../docs/configuring-playbook-bot-draupnir.md:237
 msgid ""
 "To **see the configuration options for a given protection**, send a "
 "`!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get "
 "JoinWaveShortCircuit`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:191
+#: ../../../docs/configuring-playbook-bot-draupnir.md:239
 msgid ""
 "To **set a specific option for a given protection**, send a command like "
 "this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. "
 "`!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:193
+#: ../../../docs/configuring-playbook-bot-draupnir.md:241
 msgid ""
 "To **enable a given protection**, send a command like this: `!draupnir "
 "enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:195
+#: ../../../docs/configuring-playbook-bot-draupnir.md:243
 msgid ""
 "To **disable a given protection**, send a command like this: `!draupnir "
 "disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:197
-msgid "Extending the configuration"
-msgstr ""
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/the-draupnir-project/Draupnir) to learn "
+#~ "what it does and why it might "
+#~ "be useful to you."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:199
-msgid ""
-"You can configure additional options by adding the "
-"`matrix_bot_draupnir_configuration_extension_yaml` variable to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file."
-msgstr ""
+#~ msgid "If your migrating from Mjolnir skip to step 5b."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:201
-msgid ""
-"For example to change Draupnir's `recordIgnoredInvites` option to `true` "
-"you would add the following to your `vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "The playbook does not automatically "
+#~ "create users for you. The bot "
+#~ "requires an access token to be "
+#~ "able to connect to your homeserver."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:215
-msgid "Abuse Reports"
-msgstr ""
+#~ msgid ""
+#~ "You **need to register the bot "
+#~ "user manually** before setting up the"
+#~ " bot."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:217
-msgid "Draupnir supports two methods to receive reports in the management room."
-msgstr ""
+#~ msgid ""
+#~ "If you would like Draupnir to be"
+#~ " able to deactivate users, move "
+#~ "aliases, shutdown rooms, show abuse "
+#~ "reports ([see below](#abuse-reports)), etc "
+#~ "then it must be a server admin "
+#~ "so you need to change `admin=no` "
+#~ "to `admin=yes` in the command above."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:219
-msgid ""
-"The first method intercepts the report API endpoint of the client-server "
-"API, which requires integration with the reverse proxy in front of the "
-"homeserver. If you are using traefik, this playbook can set this up for "
-"you:"
-msgstr ""
+#~ msgid ""
+#~ "Refer to the documentation on [how "
+#~ "to obtain an access token](obtaining-"
+#~ "access-tokens.md)."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:225
-msgid ""
-"The other method polls an synapse admin API endpoint and is hence only "
-"available when using synapse and when the Draupnir user is an admin user "
-"(see step 1). To enable it, set `pollReports: true` in Draupnir's config:"
-msgstr ""
+#~ msgid ""
+#~ "You will need to prevent Synapse "
+#~ "from rate limiting the bot's account."
+#~ " This is not an optional step. "
+#~ "If you do not do this step "
+#~ "Draupnir will crash. This can be "
+#~ "done using Synapse's [admin API](https"
+#~ "://matrix-"
+#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html"
+#~ "#override-ratelimiting-for-users). Please "
+#~ "ask for help if you are "
+#~ "uncomfortable with these steps or run"
+#~ " into issues."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If your Synapse Admin API is "
+#~ "exposed to the internet for some "
+#~ "reason like running the Synapse Admin"
+#~ " Role [Link](configuring-playbook-synapse-"
+#~ "admin.md) or running "
+#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
+#~ " true` in your playbook config. If"
+#~ " your API is not externally exposed"
+#~ " you should still be able to on"
+#~ " the local host for your synapse "
+#~ "run these commands."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The following command works on semi "
+#~ "up to date Windows 10 installs and"
+#~ " All Windows 11 installations and "
+#~ "other systems that ship curl. `curl "
+#~ "--header \"Authorization: Bearer <access_token>\""
+#~ " -X POST "
+#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`"
+#~ " Replace `@bot.draupnir:example.com` with the "
+#~ "MXID of your Draupnir and example.com"
+#~ " with your homeserver domain. You can"
+#~ " easily obtain an access token for"
+#~ " a homeserver admin account the same"
+#~ " way you can obtain an access "
+#~ "token for Draupnir itself. If you "
+#~ "made Draupnir Admin you can just "
+#~ "use the Draupnir token."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you make the management room "
+#~ "encrypted (E2EE), then you MUST enable"
+#~ " and use Pantalaimon (see below)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Decide whether you want Draupnir to "
+#~ "be capable of operating in end-"
+#~ "to-end encrypted (E2EE) rooms. This "
+#~ "includes the management room and the "
+#~ "moderated rooms. To support E2EE, "
+#~ "Draupnir needs to [use Pantalaimon"
+#~ "](configuring-playbook-pantalaimon.md)."
+#~ msgstr ""
+
+#~ msgid "a. Configuration with E2EE support"
+#~ msgstr ""
+
+#~ msgid "b. Configuration without E2EE support"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You must replace "
+#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
+#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own "
+#~ "values."
+#~ msgstr ""
+
+#~ msgid "c. Migrating from Mjolnir (Only required if migrating.)"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can configure additional options by"
+#~ " adding the "
+#~ "`matrix_bot_draupnir_configuration_extension_yaml` variable "
+#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
+#~ " file."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For example to change Draupnir's "
+#~ "`recordIgnoredInvites` option to `true` you"
+#~ " would add the following to your "
+#~ "`vars.yml` file."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The other method polls an synapse "
+#~ "admin API endpoint and is hence "
+#~ "only available when using synapse and"
+#~ " when the Draupnir user is an "
+#~ "admin user (see step 1). To enable"
+#~ " it, set `pollReports: true` in "
+#~ "Draupnir's config:"
+#~ msgstr ""
 
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
index ac819c836..ed983bb62 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -46,8 +46,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-go-neb.md:9
 msgid ""
-"See the project's [documentation](https://github.com/matrix-org/go-neb) "
-"to learn what it does and why it might be useful to you."
+"See the project's [documentation](https://github.com/matrix-org/go-"
+"neb/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-go-neb.md:11
@@ -204,3 +205,10 @@ msgid ""
 "/matrix-org/go-neb)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/go-neb) to learn what it"
+#~ " does and why it might be "
+#~ "useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
index f0140fabc..02ef49eae 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -37,9 +37,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-honoroit.md:7
 msgid ""
-"See the project's [documentation](https://github.com/etkecc/honoroit#how-"
-"it-looks-like) to learn what it does with screenshots and why it might be"
-" useful to you."
+"See the project's "
+"[documentation](https://github.com/etkecc/honoroit/blob/main/README.md) "
+"to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-honoroit.md:9
@@ -167,3 +167,11 @@ msgid ""
 "[documentation](https://github.com/etkecc/honoroit#features)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/etkecc/honoroit#how-it-"
+#~ "looks-like) to learn what it does "
+#~ "with screenshots and why it might "
+#~ "be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
index ecb6fe7c7..9d7ccf99e 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -44,7 +44,7 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:7
 msgid ""
 "See the project's [documentation](https://github.com/moan0s/matrix-"
-"registration-bot#supported-commands) to learn what it does and why it "
+"registration-bot/blob/master/README.md) to learn what it does and why it "
 "might be useful to you."
 msgstr ""
 
@@ -146,3 +146,11 @@ msgid ""
 "etc… you can use:"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/moan0s/matrix-"
+#~ "registration-bot#supported-commands) to learn "
+#~ "what it does and why it might "
+#~ "be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
index 6bb4c05e2..4875ce7c1 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -40,8 +40,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:7
 msgid ""
 "See the project's [documentation](https://github.com/anoadragon453"
-"/matrix-reminder-bot#usage) to learn what it does and why it might be "
-"useful to you."
+"/matrix-reminder-bot/blob/master/README.md) to learn what it does and why"
+" it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:9
@@ -134,3 +134,11 @@ msgid ""
 "bot#usage)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/anoadragon453/matrix-"
+#~ "reminder-bot#usage) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
index abfc1d669..2075ec200 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -33,22 +33,23 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:5
 msgid ""
-"See the project's [documentation](https://github.com/matrix-org/mjolnir) "
-"to learn what it does and why it might be useful to you."
+"See the project's [documentation](https://github.com/matrix-"
+"org/mjolnir/blob/main/README.md) to learn what it does and why it might "
+"be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:7
-msgid "Register the bot account"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:9
-msgid ""
-"The playbook does not automatically create users for you. The bot "
-"requires an access token to be able to connect to your homeserver."
+msgid "Register the bot account"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:11
-msgid "You **need to register the bot user manually** before setting up the bot."
+msgid ""
+"The playbook does not automatically create users for you. You **need to "
+"register the bot user manually** before setting up the bot."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:13
@@ -74,8 +75,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:25
 msgid ""
-"Refer to the documentation on [how to obtain an access token](obtaining-"
-"access-tokens.md)."
+"The bot requires an access token to be able to connect to your "
+"homeserver. Refer to the documentation on [how to obtain an access token"
+"](obtaining-access-tokens.md)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:27
@@ -84,43 +86,65 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:29
 msgid ""
-"You will need to prevent Synapse from rate limiting the bot's account. "
-"This is not an optional step. If you do not do this step Mjolnir will "
-"crash. This can be done using Synapse's [admin API](https://matrix-"
-"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
-"ratelimiting-for-users). Please ask for help if you are uncomfortable "
-"with these steps or run into issues."
+"If your homeserver's implementation is Synapse, you will need to prevent "
+"it from rate limiting the bot's account. **This is a required step. If "
+"you do not configure it, Mjolnir will crash.**"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:31
 msgid ""
-"If your Synapse Admin API is exposed to the internet for some reason like"
-" running the Synapse Admin Role [Link](configuring-playbook-synapse-"
-"admin.md) or running "
-"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
-" true` in your playbook config. If your API is not externally exposed you"
-" should still be able to on the local host for your synapse run these "
-"commands."
+"This can be done using Synapse's [Admin APIs](https://element-"
+"hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
+"ratelimiting-for-users). They can be accessed both externally and "
+"internally."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:33
 msgid ""
-"The following command works on semi up to date Windows 10 installs and "
-"All Windows 11 installations and other systems that ship curl. `curl "
-"--header \"Authorization: Bearer <access_token>\" -X POST "
-"https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`"
-" Replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir and "
-"example.com with your homeserver domain. You can easily obtain an access "
-"token for a homeserver admin account the same way you can obtain an "
-"access token for Mjolnir itself. If you made Mjolnir Admin you can just "
-"use the Mjolnir token."
+"To expose the APIs publicly, add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:35
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:39
+msgid ""
+"The APIs can also be accessed via [Synapse "
+"Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can "
+"use to administrate users, rooms, media, etc. on your Matrix server. The "
+"playbook can install and configure Synapse Admin for you. For details "
+"about it, see [this page](configuring-playbook-synapse-admin.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:41
+msgid ""
+"**Note**: access to the APIs is restricted with a valid access token, so "
+"exposing them publicly should not be a real security concern. Still, "
+"doing so is not recommended for additional security. See [official "
+"Synapse reverse-proxying recommendations](https://element-"
+"hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
+"endpoints)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:43
+msgid ""
+"To discharge rate limiting, run the following command on systems that "
+"ship curl (note that it does not work on outdated Windows 10). Even if "
+"the APIs are not exposed to the internet, you should still be able to run"
+" the command on the homeserver locally. Before running it, make sure to "
+"replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:49
+msgid ""
+"You can obtain an access token for a homeserver admin account in the same"
+" way as you can do so for Mjolnir itself. If you have made Mjolnir an "
+"admin, you can just use the Mjolnir token."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:51
 msgid "Create a management room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:37
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:53
 msgid ""
 "Using your own account, create a new invite only room that you will use "
 "to manage the bot. This is the room where you will see the status of the "
@@ -129,13 +153,13 @@ msgid ""
 "it is important that you only invite trusted users to this room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:39
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:55
 msgid ""
 "If you make the management room encrypted (E2EE), then you MUST enable "
-"and use Pantalaimon (see below)."
+"and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:41
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:57
 msgid ""
 "Once you have created the room you need to copy the room ID so you can "
 "tell the bot to use that room. In Element Web you can do this by going to"
@@ -143,44 +167,58 @@ msgid ""
 "room ID. The room ID will look something like `!qporfwt:example.com`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:43
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:59
 msgid ""
 "Finally invite the `@bot.mjolnir:example.com` account you created earlier"
 " into the room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:45
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:61
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:47
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:63
+msgid ""
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `MANAGEMENT_ROOM_ID_HERE`."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:72
+msgid "End-to-End Encryption support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:74
 msgid ""
 "Decide whether you want Mjolnir to be capable of operating in end-to-end "
 "encrypted (E2EE) rooms. This includes the management room and the "
-"moderated rooms. To support E2EE, Mjolnir needs to [use Pantalaimon"
-"](configuring-playbook-pantalaimon.md)."
+"moderated rooms."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:49
-msgid "a. Configuration with E2EE support"
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:76
+msgid ""
+"To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-"
+"pantalaimon.md)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:51
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:78
+msgid "Configuration with E2EE support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:80
 msgid ""
 "When using Pantalaimon, Mjolnir will log in to its bot account itself "
 "through Pantalaimon, so configure its username and password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:53
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:88
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:102
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:82
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:72
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:96
 msgid ""
 "The playbook's `group_vars` will configure other required settings. If "
 "using this role separately without the playbook, you also need to "
@@ -189,53 +227,80 @@ msgid ""
 "playbook's `group_vars`:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:84
-msgid "b. Configuration without E2EE support"
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:108
+msgid "Configuration without E2EE support"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:86
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:110
 msgid ""
 "When NOT using Pantalaimon, Mjolnir does not log in by itself and you "
 "must give it an access token for its bot account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:90
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:112
 msgid ""
-"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
-"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values."
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
+"token)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:100
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:118
 msgid "Adding Mjolnir synapse antispam module (optional)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:112
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:120
+msgid ""
+"To enable Mjolnir synapse antispam module, add the following "
+"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
+"file (adapt to your needs):"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:130
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:132
+msgid ""
+"You can configure additional options by adding the "
+"`matrix_bot_mjolnir_configuration_extension_yaml` variable to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:134
+msgid ""
+"For example, to change Mjolnir's `recordIgnoredInvites` option to `true`,"
+" add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:148
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:114
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:150
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:121
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:157
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:123
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:159
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:125
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:161
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:127
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:163
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -244,7 +309,7 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:129
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:165
 msgid ""
 "If you change the Pantalaimon's password "
 "(`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) "
@@ -255,11 +320,11 @@ msgid ""
 "know its new password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:131
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:167
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:133
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:169
 msgid ""
 "You can refer to the upstream [documentation](https://github.com/matrix-"
 "org/mjolnir) for additional ways to use and configure Mjolnir. Check out "
@@ -267,16 +332,113 @@ msgid ""
 "#quickstart-guide) for some basic commands you can give to the bot."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:135
-msgid ""
-"You can configure additional options by adding the "
-"`matrix_bot_mjolnir_configuration_extension_yaml` variable to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/mjolnir) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:137
-msgid ""
-"For example to change Mjolnir's `recordIgnoredInvites` option to `true` "
-"you would add the following to your `vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "The playbook does not automatically "
+#~ "create users for you. The bot "
+#~ "requires an access token to be "
+#~ "able to connect to your homeserver."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You **need to register the bot "
+#~ "user manually** before setting up the"
+#~ " bot."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Refer to the documentation on [how "
+#~ "to obtain an access token](obtaining-"
+#~ "access-tokens.md)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You will need to prevent Synapse "
+#~ "from rate limiting the bot's account."
+#~ " This is not an optional step. "
+#~ "If you do not do this step "
+#~ "Mjolnir will crash. This can be "
+#~ "done using Synapse's [admin API](https"
+#~ "://matrix-"
+#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html"
+#~ "#override-ratelimiting-for-users). Please "
+#~ "ask for help if you are "
+#~ "uncomfortable with these steps or run"
+#~ " into issues."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If your Synapse Admin API is "
+#~ "exposed to the internet for some "
+#~ "reason like running the Synapse Admin"
+#~ " Role [Link](configuring-playbook-synapse-"
+#~ "admin.md) or running "
+#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
+#~ " true` in your playbook config. If"
+#~ " your API is not externally exposed"
+#~ " you should still be able to on"
+#~ " the local host for your synapse "
+#~ "run these commands."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The following command works on semi "
+#~ "up to date Windows 10 installs and"
+#~ " All Windows 11 installations and "
+#~ "other systems that ship curl. `curl "
+#~ "--header \"Authorization: Bearer <access_token>\""
+#~ " -X POST "
+#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`"
+#~ " Replace `@bot.mjolnir:example.com` with the "
+#~ "MXID of your Mjolnir and example.com "
+#~ "with your homeserver domain. You can "
+#~ "easily obtain an access token for "
+#~ "a homeserver admin account the same "
+#~ "way you can obtain an access token"
+#~ " for Mjolnir itself. If you made "
+#~ "Mjolnir Admin you can just use the"
+#~ " Mjolnir token."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you make the management room "
+#~ "encrypted (E2EE), then you MUST enable"
+#~ " and use Pantalaimon (see below)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Decide whether you want Mjolnir to "
+#~ "be capable of operating in end-"
+#~ "to-end encrypted (E2EE) rooms. This "
+#~ "includes the management room and the "
+#~ "moderated rooms. To support E2EE, "
+#~ "Mjolnir needs to [use Pantalaimon"
+#~ "](configuring-playbook-pantalaimon.md)."
+#~ msgstr ""
+
+#~ msgid "a. Configuration with E2EE support"
+#~ msgstr ""
+
+#~ msgid "b. Configuration without E2EE support"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You must replace "
+#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
+#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own "
+#~ "values."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For example to change Mjolnir's "
+#~ "`recordIgnoredInvites` option to `true` you"
+#~ " would add the following to your "
+#~ "`vars.yml` file."
+#~ msgstr ""
 
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
index 6f6d15853..eb6315d87 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -45,8 +45,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:7
 msgid ""
 "See the project's [documentation](https://src.miscworks.net/fair/matrix-"
-"appservice-kakaotalk) to learn what it does and why it might be useful to"
-" you."
+"appservice-kakaotalk/src/branch/master/README.md) to learn what it does "
+"and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:9
@@ -228,3 +228,11 @@ msgid ""
 "in the future, as that would break the Double Puppeting feature"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://src.miscworks.net/fair/matrix-"
+#~ "appservice-kakaotalk) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
index 47df023ab..b322b503e 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -33,8 +33,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/kelaresg/go-skype-"
+"bridge/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:7
@@ -98,3 +99,9 @@ msgstr ""
 msgid "Send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po
index 0edf49773..919f68a76 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -43,9 +43,9 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-heisenbridge.md:7
 msgid ""
 "See the project's "
-"[README](https://github.com/hifi/heisenbridge/blob/master/README.md) to "
-"learn what it does and why it might be useful to you. You can also take a"
-" look at [this demonstration "
+"[documentation](https://github.com/hifi/heisenbridge/blob/master/README.md)"
+" to learn what it does and why it might be useful to you. You can also "
+"take a look at [this demonstration "
 "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
 msgstr ""
 
@@ -183,3 +183,13 @@ msgid ""
 "[#heisenbridge:vi.fi](https://matrix.to/#/#heisenbridge:vi.fi) for help."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[README](https://github.com/hifi/heisenbridge/blob/master/README.md)"
+#~ " to learn what it does and why"
+#~ " it might be useful to you. You"
+#~ " can also take a look at [this"
+#~ " demonstration "
+#~ "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
index dfb2b601d..394ad2aa8 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -34,15 +34,15 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:5
 msgid ""
 "Hookshot can bridge [Webhooks](https://en.wikipedia.org/wiki/Webhook) "
-"from software project management services such as GitHub, GitLab, JIRA, "
+"from software project management services such as GitHub, GitLab, Jira, "
 "and Figma, as well as generic webhooks."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:7
 msgid ""
 "See the project's [documentation](https://matrix-org.github.io/matrix-"
-"hookshot/latest/hookshot.html) to learn what it does in detail and why it"
-" might be useful to you."
+"hookshot/latest/hookshot.html) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:9
@@ -53,152 +53,172 @@ msgid ""
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:11
-msgid "Setup Instructions"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:13
-msgid ""
-"Refer to the [official instructions](https://matrix-org.github.io/matrix-"
-"hookshot/latest/setup.html) to learn what the individual options do."
+msgid "Download GitHub app private key (optional)"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:15
 msgid ""
-"Enable the bridge by adding `matrix_hookshot_enabled: true` to your "
-"`vars.yml` file"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:16
-msgid ""
-"For each of the services (GitHub, GitLab, Jira, Figma, generic webhooks) "
-"fill in the respective variables `matrix_hookshot_service_*` listed in "
-"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) as "
-"required."
+"If you're setting up the GitHub bridge, you need to create your GitHub "
+"app, and generate a private key file of it."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:17
 msgid ""
-"Take special note of the `matrix_hookshot_*_enabled` variables. Services "
-"that need no further configuration are enabled by default (GitLab, "
-"Generic), while you must first add the required configuration and enable "
-"the others (GitHub, Jira, Figma)."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:18
-msgid ""
-"If you're setting up the GitHub bridge, you'll need to generate and "
-"download a private key file after you created your GitHub app. Copy the "
-"contents of that file to the variable "
-"`matrix_hookshot_github_private_key` so the playbook can install it for "
-"you, or use one of the [other methods](#manage-github-private-key-with-"
-"aux-role) explained below."
+"You need to download the private key file, if you will install the file "
+"manually or with the `aux` role. For details, see [the section below"
+"](#manage-github-private-key-with-aux-role)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:19
-msgid ""
-"If you've already installed Matrix services using the playbook before, "
-"you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with"
-" [configuring other playbook services](configuring-playbook.md) and then "
-"with [Installing](installing.md). Get back to this guide once ready. "
-"Hookshot can be set up individually using the tag `setup-hookshot`."
+msgid "Adjusting the playbook configuration"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:21
 msgid ""
-"Other configuration options are available via the "
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `GITHUB_PRIVATE_KEY_HERE` with the one created [above](#download-"
+"github-app-private-key)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:35
+msgid ""
+"For each of the services (GitHub, GitLab, Jira, Figma, and generic "
+"webhooks) fill in the respective variables `matrix_hookshot_service_*` "
+"listed in [main.yml](../roles/custom/matrix-bridge-"
+"hookshot/defaults/main.yml) as required."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:37
+msgid ""
+"Take special note of the `matrix_hookshot_*_enabled` variables. Services "
+"that need no further configuration are enabled by default (GitLab and "
+"generic webhooks), while you must first add the required configuration "
+"and enable the others (GitHub, Jira, and Figma)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:39
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:41
+msgid ""
+"You can configure additional options by adding the "
 "`matrix_hookshot_configuration_extension_yaml` and "
-"`matrix_hookshot_registration_extension_yaml` variables, see the comments"
-" in [main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) "
-"for how to use them."
+"`matrix_hookshot_registration_extension_yaml` variables."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:23
-msgid "Finally, run the playbook (see [installing](installing.md))."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:25
-msgid "End-to-bridge encryption"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:27
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
 msgid ""
-"You can enable [encryption](https://matrix-org.github.io/matrix-"
-"hookshot/latest/advanced/encryption.html) for Hookshot by adding "
-"`matrix_hookshot_encryption_enabled: true` to your configuration "
-"(`vars.yml`) and [executing the playbook](installing.md) again."
+"Refer the [official instructions](https://matrix-org.github.io/matrix-"
+"hookshot/latest/setup.html) and the comments in "
+"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml) to "
+"learn what the individual options do."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:29
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:45
+msgid "Installing"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
 msgid ""
-"Should the crypto store be corrupted, you can reset it by executing this "
-"Ansible playbook with the tag `reset-hookshot-encryption` added, for "
-"example `ansible-playbook -i inventory/hosts setup.yml --tags=reset-"
-"hookshot-encryption`."
+"After configuring the playbook, run it with [playbook tags](playbook-"
+"tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:31
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:54
+msgid ""
+"The shortcut commands with the [`just` program](just.md) are also "
+"available: `just install-service hookshot` or `just setup-all`"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:56
+msgid ""
+"`just install-service hookshot` is useful for maintaining your setup "
+"quickly when its components remain unchanged. If you adjust your "
+"`vars.yml` to remove other components, you'd need to run `just setup-"
+"all`, or these components will still remain installed. Note `just setup-"
+"all` runs the `ensure-matrix-users-created` tag too."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:58
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:33
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:60
 msgid ""
 "To use the bridge, you need to create a room and invite the Hookshot bot "
 "(`@hookshot:example.com`) to it."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:35
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:62
 msgid ""
 "Make sure the bot is able to send state events (usually the Moderator "
 "power level in clients)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:37
-msgid "Send a `!hookshot help` message to see a list of help commands."
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:64
+msgid ""
+"Send `!hookshot help` to the room to see the bridge's help menu for "
+"additional commands."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:39
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:66
 msgid ""
 "Refer to [Hookshot's documentation](https://matrix-org.github.io/matrix-"
 "hookshot/latest/usage.html) for more details about using the bridge's "
 "various features."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:41
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:68
 msgid ""
-"**Important**: Note that the different listeners are bound to certain "
-"paths which might differ from those assumed by the hookshot "
-"documentation, see [URLs for bridges setup](#urls-for-bridges-setup) "
-"below."
+"💡 **Note**: the different listeners are bound to certain paths which "
+"might differ from those assumed by the hookshot documentation. See [URLs "
+"for bridges setup](#urls-for-bridges-setup) below."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:70
+msgid "Reset crypto store"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:72
+msgid ""
+"Should the crypto store be corrupted, you can reset it by executing this "
+"Ansible playbook with the tag `reset-hookshot-encryption` added:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:78
 msgid "More setup documentation"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:45
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:80
 msgid "URLs for bridges setup"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:82
 msgid ""
 "Unless indicated otherwise, the following endpoints are reachable on your"
 " `matrix.` subdomain (if the feature is enabled)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "listener"
+msgid "Listener"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "default path"
+msgid "Default path"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "variable"
+msgid "Variable"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "used as"
+msgid "Used as"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
@@ -262,7 +282,7 @@ msgid "`matrix_hookshot_jira_oauth_endpoint`"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "JIRA OAuth"
+msgid "Jira OAuth"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
@@ -349,71 +369,72 @@ msgstr ""
 msgid "Prometheus"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:61
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:96
 msgid ""
 "Also see the various `matrix_hookshot_container_labels_*` variables in "
-"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml), which"
-" expose URLs publicly."
+"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml), "
+"which expose URLs publicly"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:63
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:98
 msgid ""
 "The different listeners are also reachable *internally* in the docker-"
 "network via the container's name (configured by "
 "`matrix_hookshot_container_url`) and on different ports (e.g. "
-"`matrix_hookshot_appservice_port`). Read [main.yml](/roles/custom/matrix-"
-"bridge-hookshot/defaults/main.yml) in detail for more info."
+"`matrix_hookshot_appservice_port`). Read [main.yml](../roles/custom"
+"/matrix-bridge-hookshot/defaults/main.yml) in detail for more info."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:65
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
 msgid "Manage GitHub Private Key with aux role"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:67
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:102
 msgid ""
 "The GitHub bridge requires you to install a private key file. This can be"
 " done in multiple ways:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:68
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:104
 msgid ""
 "copy the *contents* of the downloaded file and set the variable "
 "`matrix_hookshot_github_private_key` to the contents (see example in "
-"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml))."
+"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml))."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:69
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:105
 msgid ""
 "somehow copy the file to the path `{{ matrix_hookshot_base_path }}/{{ "
 "matrix_hookshot_github_private_key_file }}` (default: `/matrix/hookshot"
 "/private-key.pem`) on the server manually."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:70
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:106
 msgid ""
 "use the [`aux` role](https://github.com/mother-of-all-self-hosting"
 "/ansible-role-aux) to copy the file from an arbitrary path on your "
 "ansible client to the correct path on the server."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:72
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:108
 msgid ""
 "To use the `aux` role, make sure the `matrix_hookshot_github_private_key`"
-" variable is empty. Then add the following additional configuration:"
+" variable is empty. Then add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:83
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:119
 msgid ""
 "For more information, see the documentation in the [default configuration"
 " of the aux role](https://github.com/mother-of-all-self-hosting/ansible-"
 "role-aux/blob/main/defaults/main.yml)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:85
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:121
 msgid "Provisioning API"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:87
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:123
 msgid ""
 "The provisioning API will be enabled automatically if you set "
 "`matrix_dimension_enabled: true` and provided a "
@@ -423,11 +444,11 @@ msgid ""
 "`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:89
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:125
 msgid "Metrics"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:91
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:127
 msgid ""
 "Metrics are **only enabled by default** if the builtin [Prometheus"
 "](configuring-playbook-prometheus-grafana.md) is enabled (by default, "
@@ -436,32 +457,32 @@ msgid ""
 "set up your own Dashboard for displaying them."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:93
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:129
 msgid ""
 "To explicitly enable metrics, use `matrix_hookshot_metrics_enabled: "
 "true`. This only exposes metrics over the container network, however."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:95
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:131
 msgid ""
 "**To collect metrics from an external Prometheus server**, besides "
 "enabling metrics as described above, you will also need to enable metrics"
 " exposure on `https://matrix.example.com/metrics/hookshot` by:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:97
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:133
 msgid ""
 "either enabling metrics exposure for Hookshot via "
 "`matrix_hookshot_metrics_proxying_enabled: true`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:98
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:134
 msgid ""
 "or enabling metrics exposure for all services via "
 "`matrix_metrics_exposure_enabled: true`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:136
 msgid ""
 "Whichever one you go with, by default metrics are exposed publicly "
 "**without** password-protection. See [the Prometheus and Grafana docs"
@@ -469,11 +490,11 @@ msgid ""
 "protection for metrics."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:102
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:138
 msgid "Collision with matrix-appservice-webhooks"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:104
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:140
 msgid ""
 "If you are also running [matrix-appservice-webhooks](configuring-"
 "playbook-bridge-appservice-webhooks.md), it reserves its namespace by the"
@@ -483,3 +504,175 @@ msgid ""
 "`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)."
 msgstr ""
 
+#~ msgid ""
+#~ "Hookshot can bridge "
+#~ "[Webhooks](https://en.wikipedia.org/wiki/Webhook) from "
+#~ "software project management services such "
+#~ "as GitHub, GitLab, JIRA, and Figma, "
+#~ "as well as generic webhooks."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "See the project's [documentation](https://matrix-"
+#~ "org.github.io/matrix-hookshot/latest/hookshot.html) to "
+#~ "learn what it does in detail and"
+#~ " why it might be useful to you."
+#~ msgstr ""
+
+#~ msgid "Setup Instructions"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Refer to the [official instructions](https"
+#~ "://matrix-org.github.io/matrix-hookshot/latest/setup.html)"
+#~ " to learn what the individual options"
+#~ " do."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Enable the bridge by adding "
+#~ "`matrix_hookshot_enabled: true` to your "
+#~ "`vars.yml` file"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For each of the services (GitHub, "
+#~ "GitLab, Jira, Figma, generic webhooks) "
+#~ "fill in the respective variables "
+#~ "`matrix_hookshot_service_*` listed in "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml) as required."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Take special note of the "
+#~ "`matrix_hookshot_*_enabled` variables. Services that"
+#~ " need no further configuration are "
+#~ "enabled by default (GitLab, Generic), "
+#~ "while you must first add the "
+#~ "required configuration and enable the "
+#~ "others (GitHub, Jira, Figma)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you're setting up the GitHub "
+#~ "bridge, you'll need to generate and "
+#~ "download a private key file after "
+#~ "you created your GitHub app. Copy "
+#~ "the contents of that file to the"
+#~ " variable `matrix_hookshot_github_private_key` so "
+#~ "the playbook can install it for "
+#~ "you, or use one of the [other "
+#~ "methods](#manage-github-private-key-with-"
+#~ "aux-role) explained below."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you've already installed Matrix "
+#~ "services using the playbook before, "
+#~ "you'll need to re-run it (`--tags"
+#~ "=setup-all,start`). If not, proceed with"
+#~ " [configuring other playbook services"
+#~ "](configuring-playbook.md) and then with "
+#~ "[Installing](installing.md). Get back to this"
+#~ " guide once ready. Hookshot can be"
+#~ " set up individually using the tag"
+#~ " `setup-hookshot`."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Other configuration options are available "
+#~ "via the `matrix_hookshot_configuration_extension_yaml` "
+#~ "and `matrix_hookshot_registration_extension_yaml` "
+#~ "variables, see the comments in "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml) for how to use "
+#~ "them."
+#~ msgstr ""
+
+#~ msgid "Finally, run the playbook (see [installing](installing.md))."
+#~ msgstr ""
+
+#~ msgid "End-to-bridge encryption"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can enable [encryption](https://matrix-"
+#~ "org.github.io/matrix-hookshot/latest/advanced/encryption.html)"
+#~ " for Hookshot by adding "
+#~ "`matrix_hookshot_encryption_enabled: true` to your"
+#~ " configuration (`vars.yml`) and [executing "
+#~ "the playbook](installing.md) again."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Should the crypto store be corrupted,"
+#~ " you can reset it by executing "
+#~ "this Ansible playbook with the tag "
+#~ "`reset-hookshot-encryption` added, for "
+#~ "example `ansible-playbook -i inventory/hosts"
+#~ " setup.yml --tags=reset-hookshot-encryption`."
+#~ msgstr ""
+
+#~ msgid "Send a `!hookshot help` message to see a list of help commands."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "**Important**: Note that the different "
+#~ "listeners are bound to certain paths "
+#~ "which might differ from those assumed"
+#~ " by the hookshot documentation, see "
+#~ "[URLs for bridges setup](#urls-for-"
+#~ "bridges-setup) below."
+#~ msgstr ""
+
+#~ msgid "listener"
+#~ msgstr ""
+
+#~ msgid "default path"
+#~ msgstr ""
+
+#~ msgid "variable"
+#~ msgstr ""
+
+#~ msgid "used as"
+#~ msgstr ""
+
+#~ msgid "JIRA OAuth"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Also see the various "
+#~ "`matrix_hookshot_container_labels_*` variables in "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml), which expose URLs "
+#~ "publicly."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The different listeners are also "
+#~ "reachable *internally* in the docker-"
+#~ "network via the container's name "
+#~ "(configured by `matrix_hookshot_container_url`) and"
+#~ " on different ports (e.g. "
+#~ "`matrix_hookshot_appservice_port`). Read "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml) in detail for more"
+#~ " info."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "copy the *contents* of the downloaded"
+#~ " file and set the variable "
+#~ "`matrix_hookshot_github_private_key` to the contents"
+#~ " (see example in [main.yml](/roles/custom"
+#~ "/matrix-bridge-hookshot/defaults/main.yml))."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "To use the `aux` role, make sure"
+#~ " the `matrix_hookshot_github_private_key` variable "
+#~ "is empty. Then add the following "
+#~ "additional configuration:"
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po
index ef36a1e26..d3f504115 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -33,8 +33,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/benkuly/matrix-sms-"
+"bridge/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:7
@@ -99,3 +100,9 @@ msgid ""
 "bridge/blob/master/README.md#user-guide) to see how this bridge works."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
index 081ced85a..76826e601 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -40,8 +40,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:7
 msgid ""
-"See the project's [documentation](https://github.com/mautrix/twitter) to "
-"learn what it does and why it might be useful to you."
+"See the project's "
+"[documentation](https://github.com/mautrix/twitter/blob/master/README.md)"
+" to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:9
@@ -49,58 +50,61 @@ msgid "Prerequisite (optional)"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:11
+msgid "Enable Appservice Double Puppet (optional)"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13
 msgid ""
 "If you want to set up [Double "
 "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
 "(hint: you most likely do) for this bridge automatically, you need to "
 "have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
-"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
-"secret-auth.md) service for this playbook."
+"double-puppet.md) service for this playbook."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15
 msgid ""
 "For details about configuring Double Puppeting for this bridge, see the "
 "section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:19
 msgid ""
 "To enable the bridge, add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:23
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:27
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:32
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -109,71 +113,60 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:44
 msgid ""
 "You then need to start a chat with `@twitterbot:example.com` (where "
 "`example.com` is your base domain, not the `matrix.` domain)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:43
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45
 msgid ""
 "Send login-cookie to start the login. The bot should respond with "
 "instructions on how to proceed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47
 msgid ""
 "You can learn more here about authentication from the bridge's [official "
 "documentation on "
 "Authentication](https://docs.mau.fi/bridges/python/twitter/authentication.html)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49
 msgid "💡 Set up Double Puppeting"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51
 msgid ""
 "After successfully enabling bridging, you may wish to set up [Double "
 "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
 "(hint: you most likely do)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53
 msgid "To set it up, you have 2 ways of going about it."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53
-msgid ""
-"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
-"Secret Auth"
-msgstr ""
-
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:55
-msgid ""
-"The bridge automatically performs Double Puppeting if [Appservice Double "
-"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
-"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
-"configured and enabled on the server for this playbook."
+msgid "Method 1: automatically, by enabling Appservice Double Puppet"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:57
 msgid ""
-"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
-"double-puppet.md) is the recommended way of setting up Double Puppeting, "
-"as it's easier to accomplish, works for all your users automatically, and"
-" has less of a chance of breaking in the future."
+"The bridge automatically performs Double Puppeting if [Appservice Double "
+"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
+"configured and enabled on the server for this playbook."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:59
 msgid ""
-"Enabling double puppeting by enabling the [Shared Secret Auth"
-"](configuring-playbook-shared-secret-auth.md) service works at the time "
-"of writing, but is deprecated and will stop working in the future."
+"This is the recommended way of setting up Double Puppeting, as it's "
+"easier to accomplish, works for all your users automatically, and has "
+"less of a chance of breaking in the future."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:61
@@ -182,9 +175,88 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:63
 msgid ""
-"This method is currently not available for the Mautrix-Twitter bridge, "
-"but is on the "
-"[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md) "
-"under Misc/Manual login with `login-matrix`"
+"When using this method, **each user** that wishes to enable Double "
+"Puppeting needs to follow the following steps:"
 msgstr ""
 
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:65
+msgid ""
+"retrieve a Matrix access token for yourself. Refer to the documentation "
+"on [how to do that](obtaining-access-tokens.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67
+msgid ""
+"send the access token to the bot. Example: `login-matrix "
+"MATRIX_ACCESS_TOKEN_HERE`"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:69
+msgid ""
+"make sure you don't log out the `Mautrix-Slack` device some time in the "
+"future, as that would break the Double Puppeting feature"
+msgstr ""
+
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/mautrix/twitter) to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you want to set up [Double "
+#~ "Puppeting](https://docs.mau.fi/bridges/general/double-"
+#~ "puppeting.html) (hint: you most likely "
+#~ "do) for this bridge automatically, you"
+#~ " need to have enabled [Appservice "
+#~ "Double Puppet](configuring-playbook-appservice-"
+#~ "double-puppet.md) or [Shared Secret Auth"
+#~ "](configuring-playbook-shared-secret-auth.md) "
+#~ "service for this playbook."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Method 1: automatically, by enabling "
+#~ "Appservice Double Puppet or Shared "
+#~ "Secret Auth"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The bridge automatically performs Double "
+#~ "Puppeting if [Appservice Double Puppet"
+#~ "](configuring-playbook-appservice-double-"
+#~ "puppet.md) or [Shared Secret Auth"
+#~ "](configuring-playbook-shared-secret-auth.md) "
+#~ "service is configured and enabled on "
+#~ "the server for this playbook."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Enabling [Appservice Double Puppet](configuring-"
+#~ "playbook-appservice-double-puppet.md) is "
+#~ "the recommended way of setting up "
+#~ "Double Puppeting, as it's easier to "
+#~ "accomplish, works for all your users "
+#~ "automatically, and has less of a "
+#~ "chance of breaking in the future."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Enabling double puppeting by enabling "
+#~ "the [Shared Secret Auth](configuring-"
+#~ "playbook-shared-secret-auth.md) service "
+#~ "works at the time of writing, but"
+#~ " is deprecated and will stop working"
+#~ " in the future."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "This method is currently not available"
+#~ " for the Mautrix-Twitter bridge, but"
+#~ " is on the "
+#~ "[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md)"
+#~ " under Misc/Manual login with `login-"
+#~ "matrix`"
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po
index 6a2c5924a..91e79ff01 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -36,8 +36,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:5
 msgid ""
 "See the project's "
-"[documentation](https://github.com/mautrix/wsproxy#readme) to learn what "
-"it does and why it might be useful to you."
+"[documentation](https://github.com/mautrix/wsproxy/blob/master/README.md)"
+" to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:7
@@ -144,3 +144,10 @@ msgid ""
 "running `android-sms` and/or `matrix-imessage` on your device(s)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/mautrix/wsproxy#readme) to"
+#~ " learn what it does and why it"
+#~ " might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
index 26c2b1f5b..f71b36d15 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -55,8 +55,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:9
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://gitlab.com/mx-puppet/discord"
+"/mx-puppet-discord/blob/master/README.md) to learn what it does and why "
+"it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:11
@@ -138,3 +139,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
index 9aa89f8cd..eb1a89f86 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -34,8 +34,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://gitlab.com/xangelix-pub/matrix"
+"/mx-puppet-groupme/blob/master/README.md) to learn what it does and why "
+"it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:7
@@ -122,3 +123,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
index 93cc2b2bc..344a58cfc 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -41,8 +41,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:7
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://gitlab.com/mx-puppet/slack/mx-"
+"puppet-slack/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:9
@@ -135,3 +136,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
index 41cb05e14..f39f3bcfd 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -33,8 +33,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/icewind1991/mx-"
+"puppet-steam/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:7
@@ -115,3 +116,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
index de0581490..8b1dec811 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -40,8 +40,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:7
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/Sorunome/mx-puppet-"
+"twitter/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:9
@@ -129,3 +130,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
index e16cef9a6..d35e570a5 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -42,8 +42,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-postmoogle.md:9
 msgid ""
-"See the project's [documentation](https://github.com/etkecc/postmoogle) "
-"to learn what it does and why it might be useful to you."
+"See the project's "
+"[documentation](https://github.com/etkecc/postmoogle/blob/master/README.md)"
+" to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-postmoogle.md:11
@@ -192,3 +193,10 @@ msgid ""
 " it to `DEBUG` with the following additional configuration:"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/etkecc/postmoogle) to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po
index 95a401bfa..24e25c999 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -34,8 +34,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-wechat.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/duo/matrix-"
+"wechat/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-wechat.md:7
@@ -97,3 +98,9 @@ msgstr ""
 msgid "Send `help` to the bot to see the available commands."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
index 199006251..18d078a8e 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -227,33 +227,59 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-email2matrix.md:87
 msgid ""
-"To enable Email2Matrix, run the playbook with [playbook tags](playbook-"
+"After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:93
+#: ../../../docs/configuring-playbook-email2matrix.md:94
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:95
+#: ../../../docs/configuring-playbook-email2matrix.md:96
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
-"available: `just run-tags setup-email2matrix,start` or `just setup-all`"
+"available: `just install-service email2matrix` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:97
+#: ../../../docs/configuring-playbook-email2matrix.md:98
 msgid ""
-"`just run-tags setup-email2matrix,start` is useful for maintaining your "
-"setup quickly when its components remain unchanged. If you adjust your "
+"`just install-service email2matrix` is useful for maintaining your setup "
+"quickly when its components remain unchanged. If you adjust your "
 "`vars.yml` to remove other components, you'd need to run `just setup-"
 "all`, or these components will still remain installed. Note `just setup-"
 "all` runs the `ensure-matrix-users-created` tag too."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:99
+#: ../../../docs/configuring-playbook-email2matrix.md:100
 msgid ""
 "After installation, you may wish to send a test email to the email "
 "address assigned to `mailbox1` (default: `mailbox1@matrix.example.com`) "
 "to make sure that Email2Matrix works as expected."
 msgstr ""
 
+#~ msgid ""
+#~ "To enable Email2Matrix, run the playbook"
+#~ " with [playbook tags](playbook-tags.md) as"
+#~ " below:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The shortcut commands with the [`just`"
+#~ " program](just.md) are also available: "
+#~ "`just run-tags setup-email2matrix,start` "
+#~ "or `just setup-all`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "`just run-tags setup-email2matrix,start` "
+#~ "is useful for maintaining your setup "
+#~ "quickly when its components remain "
+#~ "unchanged. If you adjust your `vars.yml`"
+#~ " to remove other components, you'd "
+#~ "need to run `just setup-all`, or"
+#~ " these components will still remain "
+#~ "installed. Note `just setup-all` runs"
+#~ " the `ensure-matrix-users-created` "
+#~ "tag too."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po
index ebb1713a3..201c1802b 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -36,8 +36,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-ldap-auth.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you."
+"See the project's [documentation](https://github.com/matrix-org/matrix-"
+"synapse-ldap3/blob/main/README.rst) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-ldap-auth.md:7
@@ -82,3 +83,9 @@ msgid ""
 "](configuring-playbook-matrix-ldap-registration-proxy.md)."
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po
index 96aae51be..50a616c77 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -53,8 +53,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-ma1sd.md:9
 msgid ""
-"See the project's [documentation](https://github.com/ma1uta/ma1sd) to "
-"learn what it does and why it might be useful to you."
+"See the project's "
+"[documentation](https://github.com/ma1uta/ma1sd/blob/master/README.md) to"
+" learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-ma1sd.md:11
@@ -333,3 +334,10 @@ msgid ""
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/ma1uta/ma1sd) to learn"
+#~ " what it does and why it might"
+#~ " be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po
index 81721ce7b..76289ff29 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -43,101 +43,107 @@ msgstr ""
 msgid ""
 "In short, it's a sort of automation and firewalling service, which is "
 "helpful if you're instaling Matrix services in a controlled corporate "
-"environment. See that project's documentation to learn what it does and "
-"why it might be useful to you."
+"environment."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-matrix-corporal.md:13
 msgid ""
+"See the project's [documentation](https://github.com/devture/matrix-"
+"corporal/blob/main/README.md) to learn what it does and why it might be "
+"useful to you."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-matrix-corporal.md:15
+msgid ""
 "If you decide that you'd like to let this playbook install it for you, "
 "you'd need to also:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:14
+#: ../../../docs/configuring-playbook-matrix-corporal.md:16
 msgid ""
 "(required) [set up the Shared Secret Auth password provider module"
 "](configuring-playbook-shared-secret-auth.md)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:15
+#: ../../../docs/configuring-playbook-matrix-corporal.md:17
 msgid ""
 "(optional, but encouraged) [set up the REST authentication password "
 "provider module](configuring-playbook-rest-auth.md)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:17
+#: ../../../docs/configuring-playbook-matrix-corporal.md:19
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:19
+#: ../../../docs/configuring-playbook-matrix-corporal.md:21
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:72
+#: ../../../docs/configuring-playbook-matrix-corporal.md:74
 msgid ""
 "Matrix Corporal operates with a specific Matrix user on your server. By "
 "default, it's `matrix-corporal` (controllable by the "
 "`matrix_corporal_reconciliation_user_id_local_part` setting, see above)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:74
+#: ../../../docs/configuring-playbook-matrix-corporal.md:76
 msgid ""
 "No matter what Matrix user ID you configure to run it with, make sure "
 "that:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:76
+#: ../../../docs/configuring-playbook-matrix-corporal.md:78
 msgid ""
 "the Matrix Corporal user is created by [registering it](registering-"
 "users.md) **with administrator privileges**. Use a password you remember,"
 " as you'll need to log in from time to time to create or join rooms"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:78
+#: ../../../docs/configuring-playbook-matrix-corporal.md:80
 msgid ""
 "the Matrix Corporal user is joined and has Admin/Moderator-level access "
 "to any rooms you want it to manage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:80
+#: ../../../docs/configuring-playbook-matrix-corporal.md:82
 msgid "Using a locally-stored static policy"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:82
+#: ../../../docs/configuring-playbook-matrix-corporal.md:84
 msgid ""
 "If you'd like to use a [static policy file](https://github.com/devture"
 "/matrix-corporal/blob/master/docs/policy-providers.md#static-file-pull-"
 "style-policy-provider), you can use a configuration like this:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:114
+#: ../../../docs/configuring-playbook-matrix-corporal.md:116
 msgid ""
 "To learn more about what the policy configuration, see the matrix-"
 "corporal documentation on [policy](https://github.com/devture/matrix-"
 "corporal/blob/master/docs/policy.md)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:116
+#: ../../../docs/configuring-playbook-matrix-corporal.md:118
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:118
+#: ../../../docs/configuring-playbook-matrix-corporal.md:120
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:125
+#: ../../../docs/configuring-playbook-matrix-corporal.md:127
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just run-tags setup-aux-files,setup-corporal,start` or `just "
 "setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:127
+#: ../../../docs/configuring-playbook-matrix-corporal.md:129
 msgid ""
 "`just run-tags setup-aux-files,setup-corporal,start` is useful for "
 "maintaining your setup quickly when its components remain unchanged. If "
@@ -146,33 +152,33 @@ msgid ""
 "`just setup-all` runs the `ensure-matrix-users-created` tag too."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:129
+#: ../../../docs/configuring-playbook-matrix-corporal.md:131
 msgid "Matrix Corporal files"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:131
+#: ../../../docs/configuring-playbook-matrix-corporal.md:133
 msgid ""
 "The following local filesystem paths are mounted in the `matrix-corporal`"
 " container and can be used in your configuration (or policy):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:133
+#: ../../../docs/configuring-playbook-matrix-corporal.md:135
 msgid "`/matrix/corporal/config` is mounted at `/etc/matrix-corporal` (read-only)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:135
+#: ../../../docs/configuring-playbook-matrix-corporal.md:137
 msgid ""
 "`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and "
 "write)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:137
+#: ../../../docs/configuring-playbook-matrix-corporal.md:139
 msgid ""
 "`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read"
 " and write)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:139
+#: ../../../docs/configuring-playbook-matrix-corporal.md:141
 msgid ""
 "As an example: you can create your own configuration files in "
 "`/matrix/corporal/config` and they will appear in `/etc/matrix-corporal` "
@@ -183,3 +189,13 @@ msgid ""
 "and write)."
 msgstr ""
 
+#~ msgid ""
+#~ "In short, it's a sort of "
+#~ "automation and firewalling service, which "
+#~ "is helpful if you're instaling Matrix"
+#~ " services in a controlled corporate "
+#~ "environment. See that project's documentation"
+#~ " to learn what it does and why"
+#~ " it might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po
index 770043c21..d5a6e3ef0 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -35,7 +35,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-pantalaimon.md:5
 msgid ""
 "See the project's [documentation](https://github.com/matrix-"
-"org/pantalaimon) to learn what it does and why it might be useful to you."
+"org/pantalaimon/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-pantalaimon.md:7
@@ -91,3 +92,10 @@ msgid ""
 "these shortcuts run the `ensure-matrix-users-created` tag too."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/pantalaimon) to learn what it"
+#~ " does and why it might be "
+#~ "useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po
index 64f262b10..50a5e7e41 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-rest-auth.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -32,8 +32,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-rest-auth.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you."
+"See the project's [documentation](https://github.com/ma1uta/matrix-"
+"synapse-rest-password-provider/blob/master/README.md) to learn what it "
+"does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-rest-auth.md:7
@@ -84,3 +85,9 @@ msgid ""
 "these shortcuts run the `ensure-matrix-users-created` tag too."
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po
index 06e5c3081..3cdbd4254 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -36,8 +36,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-shared-secret-auth.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you."
+"See the project's [documentation](https://github.com/devture/matrix-"
+"synapse-shared-secret-auth/blob/master/README.md) to learn what it does "
+"and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-shared-secret-auth.md:7
@@ -87,3 +88,9 @@ msgid ""
 "these shortcuts run the `ensure-matrix-users-created` tag too."
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po
index 6ab90bf55..2954af972 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-sygnal.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -33,8 +33,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-sygnal.md:5
 msgid ""
-"See the project's [documentation](https://github.com/matrix-org/sygnal) "
-"to learn what it does and why it might be useful to you."
+"See the project's [documentation](https://github.com/matrix-"
+"org/sygnal/blob/master/README.md) to learn what it does and why it might "
+"be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-sygnal.md:7
@@ -200,3 +201,10 @@ msgid ""
 "/matrix-org/sygnal/blob/master/docs/applications.md) document."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/sygnal) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po
index b7dce7685..257927ce2 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -34,15 +34,20 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:5
 msgid ""
-"See that project's [documentation](https://github.com/matrix-org/synapse-"
-"auto-accept-invite) to learn what it does and why it might be useful to "
-"you. In short, it automatically accepts room invites. You can specify "
-"that only 1:1 room invites are auto-accepted. Defaults to false if not "
+"In short, it automatically accepts room invites. You can specify that "
+"only 1:1 room invites are auto-accepted. Defaults to false if not "
 "specified."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:7
 msgid ""
+"See the project's [documentation](https://github.com/matrix-org/synapse-"
+"auto-accept-invite/blob/main/README.md) to learn what it does and why it "
+"might be useful to you."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9
+msgid ""
 "**Note**: Synapse [v1.109.0](https://github.com/element-"
 "hq/synapse/releases/tag/v1.109.0), the same feature [has been "
 "merged](https://github.com/element-hq/synapse/pull/17147) into Synapse "
@@ -52,11 +57,11 @@ msgid ""
 "party module."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11
 msgid "Configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:13
 msgid ""
 "If you decide that you'd like to let this playbook install the [synapse-"
 "auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-"
@@ -64,11 +69,11 @@ msgid ""
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:19
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21
 msgid "Synapse worker deployments"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:23
 msgid ""
 "In a [workerized Synapse deployment](https://github.com/spantaleev"
 "/matrix-docker-ansible-"
@@ -78,17 +83,17 @@ msgid ""
 "is `null`). For example, add this to your configuration:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:27
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29
 msgid ""
 "There might be an [issue with federation](https://github.com/matrix-org"
 "/synapse-auto-accept-invite/issues/18)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31
 msgid "Native alternative"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33
 msgid ""
 "Since Synapse [v1.109.0](https://github.com/element-"
 "hq/synapse/releases/tag/v1.109.0), the functionality provided by the "
@@ -97,7 +102,19 @@ msgid ""
 "/element-hq/synapse/pull/17147) part of Synapse."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:35
 msgid "Here's example configuration for using the **native** Synapse feature:"
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's "
+#~ "[documentation](https://github.com/matrix-org/synapse-"
+#~ "auto-accept-invite) to learn what it"
+#~ " does and why it might be "
+#~ "useful to you. In short, it "
+#~ "automatically accepts room invites. You "
+#~ "can specify that only 1:1 room "
+#~ "invites are auto-accepted. Defaults to"
+#~ " false if not specified."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po
index 9d7430ffd..46ecd6c5a 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -41,8 +41,9 @@ msgstr ""
 #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:7
 msgid ""
 "See the project's [documentation](https://github.com/matrix-org/rust-"
-"synapse-compress-state/#automated-tool-synapse_auto_compressor) to learn "
-"what it does and why it might be useful to you."
+"synapse-compress-state/blob/master/README.md#automated-tool-"
+"synapse_auto_compressor) to learn what it does and why it might be useful"
+" to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:9
@@ -107,3 +108,11 @@ msgid ""
 "unstable."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/rust-synapse-compress-state"
+#~ "/#automated-tool-synapse_auto_compressor) to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po
index 823f71180..b28d1a365 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -33,20 +33,35 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you. In short, it lets you fight invite-spam by "
-"automatically blocking invitiations from a list of servers specified by "
-"you (blacklisting)."
+"It lets you fight invite-spam by automatically blocking invitiations from"
+" a list of servers specified by you (blacklisting)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:7
-msgid "Adjusting the playbook configuration"
+msgid ""
+"See the project's [documentation](https://github.com/t2bot/synapse-"
+"simple-antispam/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:9
+msgid "Adjusting the playbook configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-synapse-simple-antispam.md:11
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you. In short,"
+#~ " it lets you fight invite-spam "
+#~ "by automatically blocking invitiations from"
+#~ " a list of servers specified by "
+#~ "you (blacklisting)."
+#~ msgstr ""
+
diff --git a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
index 20c5ed834..7b5148329 100644
--- a/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
+++ b/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: bg\n"
@@ -238,71 +238,71 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-user-verification-service.md:90
 msgid ""
-"After these variables have been set, run the playbook with [playbook tags"
-"](playbook-tags.md) as below to restart UVS:"
+"After configuring the playbook, run it with [playbook tags](playbook-"
+"tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:96
+#: ../../../docs/configuring-playbook-user-verification-service.md:97
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
-"available: `just run-tags setup-matrix-user-verification-service,start` "
-"or `just setup-all`"
+"available: `just install-service matrix-user-verification-service` or "
+"`just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:98
+#: ../../../docs/configuring-playbook-user-verification-service.md:99
 msgid ""
-"`just run-tags setup-matrix-user-verification-service,start` is useful "
-"for maintaining your setup quickly when its components remain unchanged. "
-"If you adjust your `vars.yml` to remove other components, you'd need to "
-"run `just setup-all`, or these components will still remain installed. "
-"Note `just setup-all` runs the `ensure-matrix-users-created` tag too."
+"`just install-service matrix-user-verification-service` is useful for "
+"maintaining your setup quickly when its components remain unchanged. If "
+"you adjust your `vars.yml` to remove other components, you'd need to run "
+"`just setup-all`, or these components will still remain installed. Note "
+"`just setup-all` runs the `ensure-matrix-users-created` tag too."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:100
+#: ../../../docs/configuring-playbook-user-verification-service.md:101
 msgid "Logging"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:102
+#: ../../../docs/configuring-playbook-user-verification-service.md:103
 msgid "The configuration variable `UVS_LOG_LEVEL` can be set to:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:103
+#: ../../../docs/configuring-playbook-user-verification-service.md:104
 msgid "warning"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:104
+#: ../../../docs/configuring-playbook-user-verification-service.md:105
 msgid "info"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:105
+#: ../../../docs/configuring-playbook-user-verification-service.md:106
 msgid "debug"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:107
+#: ../../../docs/configuring-playbook-user-verification-service.md:108
 msgid "TLS Certificate Checking"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:109
+#: ../../../docs/configuring-playbook-user-verification-service.md:110
 msgid ""
 "If the Matrix Homeserver does not provide a valid TLS certificate, UVS "
 "will fail with the following error message:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:111
+#: ../../../docs/configuring-playbook-user-verification-service.md:112
 msgid "message: 'No response received: [object Object]',"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:113
+#: ../../../docs/configuring-playbook-user-verification-service.md:114
 msgid "This also applies to self-signed and let's encrypt staging certificates."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:115
+#: ../../../docs/configuring-playbook-user-verification-service.md:116
 msgid ""
 "To disable certificate validation altogether (INSECURE! Not suitable for "
 "production use!) set: `NODE_TLS_REJECT_UNAUTHORIZED=0`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:117
+#: ../../../docs/configuring-playbook-user-verification-service.md:118
 msgid ""
 "Alternatively, it is possible to inject your own CA certificates into the"
 " container by mounting a PEM file with additional trusted CAs into the "
@@ -310,3 +310,31 @@ msgid ""
 "it."
 msgstr ""
 
+#~ msgid ""
+#~ "After these variables have been set, "
+#~ "run the playbook with [playbook tags"
+#~ "](playbook-tags.md) as below to restart "
+#~ "UVS:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The shortcut commands with the [`just`"
+#~ " program](just.md) are also available: "
+#~ "`just run-tags setup-matrix-user-"
+#~ "verification-service,start` or `just setup-"
+#~ "all`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "`just run-tags setup-matrix-user-"
+#~ "verification-service,start` is useful for "
+#~ "maintaining your setup quickly when its"
+#~ " components remain unchanged. If you "
+#~ "adjust your `vars.yml` to remove other"
+#~ " components, you'd need to run `just"
+#~ " setup-all`, or these components will"
+#~ " still remain installed. Note `just "
+#~ "setup-all` runs the `ensure-matrix-"
+#~ "users-created` tag too."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/README.po b/i18n/locales/jp/LC_MESSAGES/README.po
index b40cd4e22..41e9558db 100644
--- a/i18n/locales/jp/LC_MESSAGES/README.po
+++ b/i18n/locales/jp/LC_MESSAGES/README.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -53,7 +53,10 @@ msgid ""
 "This [Ansible](https://www.ansible.com/) playbook is meant to help you "
 "run your own [Matrix](http://matrix.org/) homeserver, along with the "
 "[various services](#supported-services) related to that."
-msgstr "この [Ansible](https://www.ansible.com/) Playbook は、独自の [Matrix](http://matrix.org/) ホームサーバーと、それに関連する [さまざまなサービス](#supported-services) を実行するのに役立つことを目的としています。"
+msgstr ""
+"この [Ansible](https://www.ansible.com/) Playbook は、独自の "
+"[Matrix](http://matrix.org/) ホームサーバーと、それに関連する [さまざまなサービス](#supported-"
+"services) を実行するのに役立つことを目的としています。"
 
 #: ../../../README.md:9
 msgid ""
@@ -1349,11 +1352,25 @@ msgid ""
 "deploy/issues)"
 msgstr ""
 
-#: ../../../README.md:215
+#: ../../../README.md:201
+msgid "🌐 Translation"
+msgstr ""
+
+#: ../../../README.md:203
+msgid ""
+"See the [i18n/README.md](i18n/README.md) file for more information about "
+"translation."
+msgstr ""
+
+#: ../../../README.md:205
+msgid "Translations are still work in progress."
+msgstr ""
+
+#: ../../../README.md:207
 msgid "🤝 Related"
 msgstr ""
 
-#: ../../../README.md:217
+#: ../../../README.md:209
 msgid ""
 "You may also be interested in [mash-playbook](https://github.com/mother-"
 "of-all-self-hosting/mash-playbook) - another Ansible playbook for self-"
@@ -1362,7 +1379,7 @@ msgid ""
 "playbook/blob/main/docs/supported-services.md))."
 msgstr ""
 
-#: ../../../README.md:219
+#: ../../../README.md:211
 msgid ""
 "mash-playbook also makes use of [Traefik](./docs/configuring-playbook-"
 "traefik.md) as its reverse-proxy, so with minor [interoperability "
@@ -1371,3 +1388,4 @@ msgid ""
 "ansible-deploy and mash-playbook co-exist and host Matrix and non-Matrix "
 "services on the same server."
 msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
index eb7387679..ef770ef02 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-alertmanager-receiver.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -40,19 +40,12 @@ msgstr ""
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:5
 msgid ""
 "See the project's [documentation](https://github.com/metio/matrix-"
-"alertmanager-receiver) to learn more about what this component does and "
-"why it might be useful to you."
+"alertmanager-receiver/blob/main/README.md) to learn what it does and why "
+"it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:7
 msgid ""
-"At the moment, **setting up this service's bot requires some manual "
-"actions** as described below in [Account and room preparation](#account-"
-"and-room-preparation)."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9
-msgid ""
 "This service is meant to be used with an external "
 "[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) "
 "instance. It's **not** meant to be integrated with the [Prometheus & "
@@ -61,27 +54,93 @@ msgid ""
 "it."
 msgstr ""
 
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:9
+msgid "Prerequisites"
+msgstr ""
+
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:11
-msgid "Adjusting the playbook configuration"
+msgid "Register the bot account"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-alertmanager-receiver.md:13
 msgid ""
-"To enable matrix-alertmanager-receiver, add the following configuration "
-"to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
+"This service uses a bot (with a username specified in "
+"`matrix_alertmanager_receiver_config_matrix_user_id_localpart`) for "
+"delivering messages."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:36
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:15
+msgid ""
+"The playbook does not automatically create users for you. You **need to "
+"register the bot user manually** before setting up the bot."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:17
+msgid ""
+"Choose a strong password for the bot. You can generate a good password "
+"with a command like this: `pwgen -s 64 1`."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:19
+msgid "You can use the playbook to [register a new user](registering-users.md):"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:25
+msgid "Get an access token"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:27
+msgid ""
+"The bot requires an access token to be able to connect to your "
+"homeserver. Refer to the documentation on [how to obtain an access token"
+"](obtaining-access-tokens.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:29
+msgid "Join to rooms as the bot manually"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:31
+msgid ""
+"ℹ️ **This bot does not accept room invitations automatically**. To "
+"deliver messages to rooms, the bot must be joined to all rooms manually."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:33
+msgid ""
+"For each new room you would like the bot to deliver alerts to, invite the"
+" bot to the room."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:35
+msgid ""
+"Then, log in as the bot using any Matrix client of your choosing, accept "
+"the room invitation from the bot's account, and log out."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:37
+msgid "Adjusting the playbook configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:39
+msgid ""
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
+"token)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:61
 msgid ""
 "See `roles/custom/matrix-alertmanager-receiver/defaults/main.yml` for "
 "additional configuration variables."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:38
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:63
 msgid "Adjusting the matrix-alertmanager-receiver URL"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:40
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:65
 msgid ""
 "By default, this playbook installs matrix-alertmanager-receiver on the "
 "`matrix.` subdomain, at the `/matrix-alertmanager-receiver` path "
@@ -90,7 +149,7 @@ msgid ""
 "to be set up**. If that's okay, you can skip this section."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:42
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67
 msgid ""
 "By tweaking the `matrix_alertmanager_receiver_hostname` and "
 "`matrix_alertmanager_receiver_path_prefix` variables, you can easily make"
@@ -98,125 +157,61 @@ msgid ""
 "default one."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:44
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69
 msgid ""
 "Example additional configuration for your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:52
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:77
 msgid "Adjusting DNS records"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:54
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:79
 msgid ""
 "If you've changed the default hostname, **you may need to adjust your "
 "DNS** records to point the matrix-alertmanager-receiver domain to the "
 "Matrix server."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:56
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:81
 msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:58
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:83
 msgid ""
 "If you've decided to use the default hostname, you won't need to do any "
 "extra DNS configuration."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:60
-msgid "Account and room preparation"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:62
-msgid ""
-"The playbook can automatically create users, but it cannot automatically "
-"obtain access tokens, nor perform any of the other manual actions below."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:64
-msgid ""
-"`matrix-alertmanager-receiver` uses a bot (with a username specified in "
-"`matrix_alertmanager_receiver_config_matrix_user_id_localpart` - see "
-"above) for delivering messages. You need to **manually register this bot "
-"acccount and obtain an access token for it**."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:66
-msgid ""
-"[Register a new user](registering-users.md): `ansible-playbook -i "
-"inventory/hosts setup.yml --extra-"
-"vars='username=bot.alertmanager.receiver password=PASSWORD_FOR_THE_BOT "
-"admin=no' --tags=register-user`"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:67
-msgid ""
-"[Obtain an access token](obtaining-access-tokens.md) for the bot's user "
-"account"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:68
-msgid "Invite the bot to a room where you'd like to alerts to be delivered"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:69
-msgid ""
-"Log in as the bot using any Matrix client of your choosing, accept the "
-"room invitation from the bot's account and log out"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:70
-msgid ""
-"(Optionally) Adjust "
-"`matrix_alertmanager_receiver_config_matrix_room_mapping` to create a "
-"mapping between the new room and its ID"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:72
-msgid ""
-"Steps 1 and 2 above only need to be done once, while preparing your "
-"[configuration](#adjusting-the-playbook-configuration)."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:74
-msgid ""
-"Steps 3 and 4 need to be done for each new room you'd like the bot to "
-"deliver alerts to. Step 5 is optional and provides cleaner `/alert/` "
-"URLs."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:76
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:78
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87
 msgid ""
-"Now that you've [prepared the bot account and room](#account-and-room-"
-"preparation), [configured the playbook](#adjusting-the-playbook-"
-"configuration), and potentially [adjusted your DNS records](#adjusting-"
-"dns-records), you can run the playbook with [playbook tags](playbook-"
-"tags.md) as below:"
+"After configuring the playbook and potentially [adjusting your DNS "
+"records](#adjusting-dns-records), run the playbook with [playbook tags"
+"](playbook-tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:85
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:94
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:87
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:96
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:89
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:98
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:91
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:100
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -225,27 +220,136 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:93
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:102
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:95
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:104
 msgid "Configure your Prometheus Alertmanager with configuration like this:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:114
+#: ../../../docs/configuring-playbook-alertmanager-receiver.md:123
 msgid ""
-".. where `URL_HERE` looks like `https://matrix.example.com/matrix-"
+"where `URL_HERE` looks like `https://matrix.example.com/matrix-"
 "alertmanager-receiver-RANDOM_VALUE_HERE/alert/some-room-name` or "
 "`https://matrix.example.com/matrix-alertmanager-receiver-"
 "RANDOM_VALUE_HERE/alert/!qporfwt:example.com`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-alertmanager-receiver.md:116
-msgid ""
-"This bot does **not** accept room invitations automatically (like many "
-"other bots do). To deliver messages to rooms, **the bot must be joined to"
-" all rooms manually** - see Step 4 of the [Account and room preparation"
-"](#account-and-room-preparation) section."
-msgstr ""
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/metio/matrix-alertmanager-"
+#~ "receiver) to learn more about what "
+#~ "this component does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "At the moment, **setting up this "
+#~ "service's bot requires some manual "
+#~ "actions** as described below in [Account"
+#~ " and room preparation](#account-and-"
+#~ "room-preparation)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "To enable matrix-alertmanager-receiver, "
+#~ "add the following configuration to your"
+#~ " `inventory/host_vars/matrix.example.com/vars.yml` file:"
+#~ msgstr ""
+
+#~ msgid "Account and room preparation"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The playbook can automatically create "
+#~ "users, but it cannot automatically "
+#~ "obtain access tokens, nor perform any"
+#~ " of the other manual actions below."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "`matrix-alertmanager-receiver` uses a "
+#~ "bot (with a username specified in "
+#~ "`matrix_alertmanager_receiver_config_matrix_user_id_localpart` -"
+#~ " see above) for delivering messages. "
+#~ "You need to **manually register this "
+#~ "bot acccount and obtain an access "
+#~ "token for it**."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "[Register a new user](registering-users.md):"
+#~ " `ansible-playbook -i inventory/hosts "
+#~ "setup.yml --extra-vars='username=bot.alertmanager.receiver"
+#~ " password=PASSWORD_FOR_THE_BOT admin=no' --tags"
+#~ "=register-user`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "[Obtain an access token](obtaining-access-"
+#~ "tokens.md) for the bot's user account"
+#~ msgstr ""
+
+#~ msgid "Invite the bot to a room where you'd like to alerts to be delivered"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Log in as the bot using any "
+#~ "Matrix client of your choosing, accept"
+#~ " the room invitation from the bot's"
+#~ " account and log out"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "(Optionally) Adjust "
+#~ "`matrix_alertmanager_receiver_config_matrix_room_mapping` to "
+#~ "create a mapping between the new "
+#~ "room and its ID"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Steps 1 and 2 above only need "
+#~ "to be done once, while preparing "
+#~ "your [configuration](#adjusting-the-playbook-"
+#~ "configuration)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Steps 3 and 4 need to be "
+#~ "done for each new room you'd like"
+#~ " the bot to deliver alerts to. "
+#~ "Step 5 is optional and provides "
+#~ "cleaner `/alert/` URLs."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Now that you've [prepared the bot "
+#~ "account and room](#account-and-room-"
+#~ "preparation), [configured the playbook"
+#~ "](#adjusting-the-playbook-configuration), and "
+#~ "potentially [adjusted your DNS records"
+#~ "](#adjusting-dns-records), you can run "
+#~ "the playbook with [playbook tags](playbook-"
+#~ "tags.md) as below:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ ".. where `URL_HERE` looks like "
+#~ "`https://matrix.example.com/matrix-alertmanager-"
+#~ "receiver-RANDOM_VALUE_HERE/alert/some-room-name` "
+#~ "or `https://matrix.example.com/matrix-alertmanager-"
+#~ "receiver-RANDOM_VALUE_HERE/alert/!qporfwt:example.com`."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "This bot does **not** accept room "
+#~ "invitations automatically (like many other "
+#~ "bots do). To deliver messages to "
+#~ "rooms, **the bot must be joined to"
+#~ " all rooms manually** - see Step "
+#~ "4 of the [Account and room "
+#~ "preparation](#account-and-room-preparation) "
+#~ "section."
+#~ msgstr ""
 
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po
index 88f283561..fc4f586b9 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-appservice-draupnir-for-all.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -83,27 +83,31 @@ msgid ""
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:19
-msgid "Installation"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:21
-msgid "Create a main management room."
+msgid "Create a main management room"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:23
 msgid ""
 "The playbook does not create a management room for your Main Draupnir. "
-"This task you have to do on your own."
+"You **need to create the room manually** before setting up the bot."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:25
+msgid "Note that the room must be unencrypted."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
 msgid ""
 "The management room has to be given an alias and be public when you are "
 "setting up the bot for the first time as the bot does not differentiate "
 "between invites and invites to the management room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:27
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:31
 msgid ""
 "This management room is used to control who has access to your D4A "
 "deployment. The room stores this data inside of the control room state so"
@@ -111,77 +115,107 @@ msgid ""
 "This is default 50 or moderator as Element clients call this powerlevel."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:29
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:33
 msgid ""
 "As noted in the Draupnir install instructions the control room is "
-"sensitive. The following is said about the control room in the Draupnir "
-"install instructions."
+"sensitive. **Anyone in this room can control the bot so it is important "
+"that you only invite trusted users to this room.**"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:30
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:35
+msgid "Set an alias to the management room"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:37
+msgid "Next, set an alias to the management room."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:39
 msgid ""
-"Anyone in this room can control the bot so it is important that you only "
-"invite trusted users to this room. The room must be unencrypted since the"
-" playbook does not support installing Pantalaimon yet."
+"This alias can be anything you want. However, for increased security "
+"during the setup phase, it is recommended to make this alias be a random "
+"string. When it has been locked down after setup phase, you can give your"
+" room a secondary human readable alias."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:32
-msgid "Give your main management room an alias."
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:41
+msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:34
-msgid ""
-"Give the room from step 1 an alias. This alias can be anything you want "
-"and its recommended for increased security during the setup phase of the "
-"bot that you make this alias be a random string. You can give your room a"
-" secondary human readable alias when it has been locked down after setup "
-"phase."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:36
-msgid "Adjusting the playbook configuration."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:38
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:43
 msgid ""
 "Add the following configuration to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
-"needs):"
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `MANAGEMENT_ROOM_ALIAS_HERE`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:40
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:51
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:53
 msgid ""
-"You must replace `ALIAS_FROM_STEP_2_GOES_HERE` with the alias you created"
-" in step 2."
+"You can configure additional options by adding the "
+"`matrix_appservice_draupnir_for_all_extension_yaml` variable."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:48
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:55
+msgid ""
+"For example, to change Draupnir's `protectAllJoinedRooms` option to "
+"`true`, add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
+msgid ""
+"You can refer to the upstream [documentation](https://github.com/the-"
+"draupnir-project/Draupnir) for more configuration documentation."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:86
+msgid "**Notes**:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
+msgid ""
+"The playbook ships a full copy of the example config that does transfer "
+"to provisioned Draupnirs in the production-bots.yaml.j2 file in the "
+"template directory of the role."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
+msgid ""
+"Config extension does not affect the appservices config as this config is"
+" not extensible in current Draupnir anyway. It instead touches the config"
+" passed to the Draupnirs that your Appservice creates. So the example "
+"above (`protectAllJoinedRooms: true`) makes all provisioned Draupnirs "
+"protect all joined rooms."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:50
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:57
-msgid "**Notes**:"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:59
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:88
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:61
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:90
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:63
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:92
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -190,29 +224,29 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:65
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:94
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:67
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:96
 msgid ""
 "If you made it through all the steps above and your main control room was"
 " joined by a user called `@draupnir-main:example.com` you have "
 "succesfully installed Draupnir for All and can now start using it."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:69
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:98
 msgid ""
 "The installation of Draupnir for all in this playbook is very much Alpha "
-"quality. Usage-wise, Draupnir for allis almost identical to Draupnir bot "
-"mode."
+"quality. Usage-wise, Draupnir for all is almost identical to Draupnir bot"
+" mode."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:71
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:100
 msgid "Granting Users the ability to use D4A"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:73
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:102
 msgid ""
 "Draupnir for all includes several security measures like that it only "
 "allows users that are on its allow list to ask for a bot. To add a user "
@@ -223,7 +257,7 @@ msgid ""
 " the chat is recomended."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:75
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:104
 msgid ""
 "The bot requires a powerlevel of 50 in the management room to control who"
 " is allowed to use the bot. The bot does currently not say anything if "
@@ -232,7 +266,7 @@ msgid ""
 "project/Draupnir/issues/297))"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:77
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:106
 msgid ""
 "To allow users or whole homeservers you type /plain @draupnir-"
 "main:example.com allow `target` and target can be either a MXID or a "
@@ -241,57 +275,146 @@ msgid ""
 "this command as it can break Wildcard commands especially."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:79
-msgid "How to provision a D4A once you are allowed to."
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:108
+msgid "How to provision a D4A once you are allowed to"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:81
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:110
 msgid ""
-"Open a DM with @draupnir-main:example.com and if using an Element client "
-"send a message into this DM to finalise creating it. The bot will reject "
-"this invite and you will shortly get invited to the Draupnir control room"
-" for your newly provisioned Draupnir. From here its just a normal "
-"Draupnir experience."
+"To provision a D4A, you need to start a chat with `@draupnir-"
+"main:example.com`. The bot will reject this invite and you will shortly "
+"get invited to the Draupnir control room for your newly provisioned "
+"Draupnir. From here its just a normal Draupnir experience."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:83
+#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:112
 msgid ""
 "Congratulations if you made it all the way here because you now have a "
 "fully working Draupnir for all deployment."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:85
-msgid "Configuration of D4A"
-msgstr ""
+#~ msgid "Installation"
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:87
-msgid ""
-"You can refer to the upstream [documentation](https://github.com/the-"
-"draupnir-project/Draupnir) for more configuration documentation. Please "
-"note that the playbook ships a full copy of the example config that does "
-"transfer to provisioned Draupnirs in the production-bots.yaml.j2 file in "
-"the template directory of the role."
-msgstr ""
+#~ msgid "Create a main management room."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:89
-msgid ""
-"Please note that Config extension does not affect the appservices config "
-"as this config is not extensible in current Draupnir anyways. Config "
-"extension instead touches the config passed to the Draupnirs that your "
-"Appservice creates. So for example below makes all provisioned Draupnirs "
-"protect all joined rooms."
-msgstr ""
+#~ msgid ""
+#~ "The playbook does not create a "
+#~ "management room for your Main Draupnir."
+#~ " This task you have to do on"
+#~ " your own."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:91
-msgid ""
-"You can configure additional options by adding the "
-"`matrix_appservice_draupnir_for_all_extension_yaml` variable to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "As noted in the Draupnir install "
+#~ "instructions the control room is "
+#~ "sensitive. The following is said about"
+#~ " the control room in the Draupnir "
+#~ "install instructions."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-appservice-draupnir-for-all.md:93
-msgid ""
-"For example to change Draupnir's `protectAllJoinedRooms` option to `true`"
-" you would add the following to your `vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "Anyone in this room can control "
+#~ "the bot so it is important that"
+#~ " you only invite trusted users to "
+#~ "this room. The room must be "
+#~ "unencrypted since the playbook does not"
+#~ " support installing Pantalaimon yet."
+#~ msgstr ""
+
+#~ msgid "Give your main management room an alias."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Give the room from step 1 an "
+#~ "alias. This alias can be anything "
+#~ "you want and its recommended for "
+#~ "increased security during the setup "
+#~ "phase of the bot that you make "
+#~ "this alias be a random string. You"
+#~ " can give your room a secondary "
+#~ "human readable alias when it has "
+#~ "been locked down after setup phase."
+#~ msgstr ""
+
+#~ msgid "Adjusting the playbook configuration."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Add the following configuration to your"
+#~ " `inventory/host_vars/matrix.example.com/vars.yml` file "
+#~ "(adapt to your needs):"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You must replace `ALIAS_FROM_STEP_2_GOES_HERE` "
+#~ "with the alias you created in step"
+#~ " 2."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The installation of Draupnir for all "
+#~ "in this playbook is very much "
+#~ "Alpha quality. Usage-wise, Draupnir for"
+#~ " allis almost identical to Draupnir "
+#~ "bot mode."
+#~ msgstr ""
+
+#~ msgid "How to provision a D4A once you are allowed to."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Open a DM with @draupnir-"
+#~ "main:example.com and if using an Element"
+#~ " client send a message into this "
+#~ "DM to finalise creating it. The "
+#~ "bot will reject this invite and "
+#~ "you will shortly get invited to "
+#~ "the Draupnir control room for your "
+#~ "newly provisioned Draupnir. From here "
+#~ "its just a normal Draupnir experience."
+#~ msgstr ""
+
+#~ msgid "Configuration of D4A"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can refer to the upstream "
+#~ "[documentation](https://github.com/the-draupnir-"
+#~ "project/Draupnir) for more configuration "
+#~ "documentation. Please note that the "
+#~ "playbook ships a full copy of the"
+#~ " example config that does transfer to"
+#~ " provisioned Draupnirs in the "
+#~ "production-bots.yaml.j2 file in the "
+#~ "template directory of the role."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Please note that Config extension does"
+#~ " not affect the appservices config as"
+#~ " this config is not extensible in "
+#~ "current Draupnir anyways. Config extension "
+#~ "instead touches the config passed to "
+#~ "the Draupnirs that your Appservice "
+#~ "creates. So for example below makes "
+#~ "all provisioned Draupnirs protect all "
+#~ "joined rooms."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can configure additional options by"
+#~ " adding the "
+#~ "`matrix_appservice_draupnir_for_all_extension_yaml` variable "
+#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
+#~ " file."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For example to change Draupnir's "
+#~ "`protectAllJoinedRooms` option to `true` you"
+#~ " would add the following to your "
+#~ "`vars.yml` file."
+#~ msgstr ""
 
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
index b1c589d9f..0e3677f70 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-draupnir.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -33,8 +33,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-draupnir.md:5
 msgid ""
 "See the project's [documentation](https://github.com/the-draupnir-"
-"project/Draupnir) to learn what it does and why it might be useful to "
-"you."
+"project/Draupnir/blob/main/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:7
@@ -46,21 +46,23 @@ msgid ""
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:9
-msgid "If your migrating from Mjolnir skip to step 5b."
+msgid ""
+"If your migrating from Mjolnir skip to [this section](#migrating-from-"
+"mjolnir-only-required-if-migrating)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:11
-msgid "Register the bot account"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:13
-msgid ""
-"The playbook does not automatically create users for you. The bot "
-"requires an access token to be able to connect to your homeserver."
+msgid "Register the bot account"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:15
-msgid "You **need to register the bot user manually** before setting up the bot."
+msgid ""
+"The playbook does not automatically create users for you. You **need to "
+"register the bot user manually** before setting up the bot."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:17
@@ -76,7 +78,7 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-draupnir.md:25
 msgid ""
 "If you would like Draupnir to be able to deactivate users, move aliases, "
-"shutdown rooms, show abuse reports ([see below](#abuse-reports)), etc "
+"shutdown rooms, show abuse reports (see [below](#abuse-reports)), etc "
 "then it must be a server admin so you need to change `admin=no` to "
 "`admin=yes` in the command above."
 msgstr ""
@@ -87,8 +89,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:29
 msgid ""
-"Refer to the documentation on [how to obtain an access token](obtaining-"
-"access-tokens.md)."
+"The bot requires an access token to be able to connect to your "
+"homeserver. Refer to the documentation on [how to obtain an access token"
+"](obtaining-access-tokens.md)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:31
@@ -97,43 +100,65 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:33
 msgid ""
-"You will need to prevent Synapse from rate limiting the bot's account. "
-"This is not an optional step. If you do not do this step Draupnir will "
-"crash. This can be done using Synapse's [admin API](https://matrix-"
-"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
-"ratelimiting-for-users). Please ask for help if you are uncomfortable "
-"with these steps or run into issues."
+"If your homeserver's implementation is Synapse, you will need to prevent "
+"it from rate limiting the bot's account. **This is a required step. If "
+"you do not configure it, Draupnir will crash.**"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:35
 msgid ""
-"If your Synapse Admin API is exposed to the internet for some reason like"
-" running the Synapse Admin Role [Link](configuring-playbook-synapse-"
-"admin.md) or running "
-"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
-" true` in your playbook config. If your API is not externally exposed you"
-" should still be able to on the local host for your synapse run these "
-"commands."
+"This can be done using Synapse's [Admin APIs](https://element-"
+"hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
+"ratelimiting-for-users). They can be accessed both externally and "
+"internally."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-draupnir.md:37
 msgid ""
-"The following command works on semi up to date Windows 10 installs and "
-"All Windows 11 installations and other systems that ship curl. `curl "
-"--header \"Authorization: Bearer <access_token>\" -X POST "
-"https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`"
-" Replace `@bot.draupnir:example.com` with the MXID of your Draupnir and "
-"example.com with your homeserver domain. You can easily obtain an access "
-"token for a homeserver admin account the same way you can obtain an "
-"access token for Draupnir itself. If you made Draupnir Admin you can just"
-" use the Draupnir token."
+"To expose the APIs publicly, add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:39
+#: ../../../docs/configuring-playbook-bot-draupnir.md:43
+msgid ""
+"The APIs can also be accessed via [Synapse "
+"Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can "
+"use to administrate users, rooms, media, etc. on your Matrix server. The "
+"playbook can install and configure Synapse Admin for you. For details "
+"about it, see [this page](configuring-playbook-synapse-admin.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:45
+msgid ""
+"**Note**: access to the APIs is restricted with a valid access token, so "
+"exposing them publicly should not be a real security concern. Still, "
+"doing so is not recommended for additional security. See [official "
+"Synapse reverse-proxying recommendations](https://element-"
+"hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
+"endpoints)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:47
+msgid ""
+"To discharge rate limiting, run the following command on systems that "
+"ship curl (note that it does not work on outdated Windows 10). Even if "
+"the APIs are not exposed to the internet, you should still be able to run"
+" the command on the homeserver locally. Before running it, make sure to "
+"replace `@bot.draupnir:example.com` with the MXID of your Draupnir:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:53
+msgid ""
+"You can obtain an access token for a homeserver admin account in the same"
+" way as you can do so for Draupnir itself. If you have made Draupnir an "
+"admin, you can just use the Draupnir token."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:55
 msgid "Create a management room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:41
+#: ../../../docs/configuring-playbook-bot-draupnir.md:57
 msgid ""
 "Using your own account, create a new invite only room that you will use "
 "to manage the bot. This is the room where you will see the status of the "
@@ -142,13 +167,13 @@ msgid ""
 "it is important that you only invite trusted users to this room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:43
+#: ../../../docs/configuring-playbook-bot-draupnir.md:59
 msgid ""
 "If you make the management room encrypted (E2EE), then you MUST enable "
-"and use Pantalaimon (see below)."
+"and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:45
+#: ../../../docs/configuring-playbook-bot-draupnir.md:61
 msgid ""
 "Once you have created the room you need to copy the room ID so you can "
 "tell the bot to use that room. In Element Web you can do this by going to"
@@ -156,43 +181,58 @@ msgid ""
 "room ID. The room ID will look something like `!qporfwt:example.com`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:47
+#: ../../../docs/configuring-playbook-bot-draupnir.md:63
 msgid ""
 "Finally invite the `@bot.draupnir:example.com` account you created "
 "earlier into the room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:49
+#: ../../../docs/configuring-playbook-bot-draupnir.md:65
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:51
+#: ../../../docs/configuring-playbook-bot-draupnir.md:67
+msgid ""
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `MANAGEMENT_ROOM_ID_HERE`."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:76
+msgid "End-to-End Encryption support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:78
 msgid ""
 "Decide whether you want Draupnir to be capable of operating in end-to-end"
 " encrypted (E2EE) rooms. This includes the management room and the "
-"moderated rooms. To support E2EE, Draupnir needs to [use Pantalaimon"
-"](configuring-playbook-pantalaimon.md)."
+"moderated rooms."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:53
-msgid "a. Configuration with E2EE support"
+#: ../../../docs/configuring-playbook-bot-draupnir.md:80
+msgid ""
+"To support E2EE, Draupnir needs to [use Pantalaimon](configuring-"
+"playbook-pantalaimon.md)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:55
+#: ../../../docs/configuring-playbook-bot-draupnir.md:82
+msgid "Configuration with E2EE support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:84
 msgid ""
 "When using Pantalaimon, Draupnir will log in to its bot account itself "
 "through Pantalaimon, so configure its username and password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:57
-#: ../../../docs/configuring-playbook-bot-draupnir.md:92
+#: ../../../docs/configuring-playbook-bot-draupnir.md:86
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:76
+#: ../../../docs/configuring-playbook-bot-draupnir.md:100
 msgid ""
 "The playbook's `group_vars` will configure other required settings. If "
 "using this role separately without the playbook, you also need to "
@@ -201,65 +241,108 @@ msgid ""
 "playbook's `group_vars`:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:88
-msgid "b. Configuration without E2EE support"
+#: ../../../docs/configuring-playbook-bot-draupnir.md:112
+msgid "Configuration without E2EE support"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:90
+#: ../../../docs/configuring-playbook-bot-draupnir.md:114
 msgid ""
 "When NOT using Pantalaimon, Draupnir does not log in by itself and you "
 "must give it an access token for its bot account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:94
+#: ../../../docs/configuring-playbook-bot-draupnir.md:116
 msgid ""
-"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
-"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values."
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
+"token)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:104
-msgid "c. Migrating from Mjolnir (Only required if migrating.)"
+#: ../../../docs/configuring-playbook-bot-draupnir.md:122
+msgid "Abuse Reports"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:106
+#: ../../../docs/configuring-playbook-bot-draupnir.md:124
+msgid "Draupnir supports two methods to receive reports in the management room."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:126
+msgid ""
+"The first method intercepts the report API endpoint of the client-server "
+"API, which requires integration with the reverse proxy in front of the "
+"homeserver. If you are using traefik, this playbook can set this up for "
+"you:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:132
+msgid ""
+"The other method polls an Synapse Admin API endpoint, hence it is "
+"available only if using Synapse and if the Draupnir user is an admin (see"
+" [above](#register-the-bot-account)). To enable it, set `pollReports: "
+"true` on `vars.yml` file as below."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:134
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:136
+msgid ""
+"You can configure additional options by adding the "
+"`matrix_bot_draupnir_configuration_extension_yaml` variable."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:138
+msgid ""
+"For example, to change Draupnir's `pollReports` option to `true`, add the"
+" following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:152
+msgid "Migrating from Mjolnir (Only required if migrating)"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-draupnir.md:154
 msgid ""
 "Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` "
 "config. Also disable Mjolnir if you're doing migration."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:108
+#: ../../../docs/configuring-playbook-bot-draupnir.md:156
 msgid ""
 "That is all you need to do due to that Draupnir can complete migration on"
 " its own."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:110
+#: ../../../docs/configuring-playbook-bot-draupnir.md:158
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:112
+#: ../../../docs/configuring-playbook-bot-draupnir.md:160
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:119
+#: ../../../docs/configuring-playbook-bot-draupnir.md:167
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:121
+#: ../../../docs/configuring-playbook-bot-draupnir.md:169
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:123
+#: ../../../docs/configuring-playbook-bot-draupnir.md:171
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:125
+#: ../../../docs/configuring-playbook-bot-draupnir.md:173
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -268,7 +351,7 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:127
+#: ../../../docs/configuring-playbook-bot-draupnir.md:175
 msgid ""
 "If you change the Pantalaimon's password "
 "(`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) "
@@ -279,32 +362,32 @@ msgid ""
 " know its new password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:129
+#: ../../../docs/configuring-playbook-bot-draupnir.md:177
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:131
+#: ../../../docs/configuring-playbook-bot-draupnir.md:179
 msgid ""
 "You can refer to the upstream [documentation](https://the-draupnir-"
 "project.github.io/draupnir-documentation/) for additional ways to use and"
 " configure Draupnir and for a more detailed usage guide."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:133
+#: ../../../docs/configuring-playbook-bot-draupnir.md:181
 msgid "Below is a **non-exhaustive quick-start guide** for the impatient."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:135
+#: ../../../docs/configuring-playbook-bot-draupnir.md:183
 msgid "Making Draupnir join and protect a room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:137
+#: ../../../docs/configuring-playbook-bot-draupnir.md:185
 msgid ""
 "Draupnir can be told to self-join public rooms, but it's better to follow"
 " this flow which works well for all kinds of rooms:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:139
+#: ../../../docs/configuring-playbook-bot-draupnir.md:187
 msgid ""
 "Invite the bot to the room manually ([inviting Draupnir to rooms](https"
 "://the-draupnir-project.github.io/draupnir-documentation/moderator"
@@ -312,13 +395,13 @@ msgid ""
 "the bot *may* ask for confirmation in the Management Room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:141
+#: ../../../docs/configuring-playbook-bot-draupnir.md:189
 msgid ""
 "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-"
 "do-its-job)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:143
+#: ../../../docs/configuring-playbook-bot-draupnir.md:191
 msgid ""
 "Tell it to protect the room (using the [rooms command](https://the-"
 "draupnir-project.github.io/draupnir-documentation/moderator/managing-"
@@ -327,7 +410,7 @@ msgid ""
 "!qporfwt:example.com`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:145
+#: ../../../docs/configuring-playbook-bot-draupnir.md:193
 msgid ""
 "To have Draupnir provide useful room protection, you need do to a bit "
 "more work (at least the first time around). You may wish to [Subscribe to"
@@ -336,11 +419,11 @@ msgid ""
 " and [Enabling built-in protections](#enabling-built-in-protections)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:147
+#: ../../../docs/configuring-playbook-bot-draupnir.md:195
 msgid "Giving Draupnir permissions to do its job"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:149
+#: ../../../docs/configuring-playbook-bot-draupnir.md:197
 msgid ""
 "For Draupnir to do its job, you need to [give it permissions](https"
 "://the-draupnir-project.github.io/draupnir-documentation/moderator"
@@ -348,7 +431,7 @@ msgid ""
 "protecting. This involves **giving it an Administrator power level**."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:151
+#: ../../../docs/configuring-playbook-bot-draupnir.md:199
 msgid ""
 "**We recommend setting this power level as soon as the bot joins your "
 "room** (and before you create new rules), so that it can apply rules as "
@@ -357,11 +440,11 @@ msgid ""
 " it)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:153
+#: ../../../docs/configuring-playbook-bot-draupnir.md:201
 msgid "Subscribing to a public policy list"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:155
+#: ../../../docs/configuring-playbook-bot-draupnir.md:203
 msgid ""
 "We recommend **subscribing to a public [policy list](https://the-"
 "draupnir-project.github.io/draupnir-documentation/concepts/policy-"
@@ -370,24 +453,24 @@ msgid ""
 "watch-command-to-subscribe-to-policy-rooms)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:157
+#: ../../../docs/configuring-playbook-bot-draupnir.md:205
 msgid ""
 "Polcy lists are maintained in Matrix rooms. A popular policy list is "
 "maintained in the public `#community-moderation-effort-bl:neko.dev` room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:159
+#: ../../../docs/configuring-playbook-bot-draupnir.md:207
 msgid ""
 "You can tell Draupnir to subscribe to it by sending the following command"
 " to the Management Room: `!draupnir watch #community-moderation-effort-"
 "bl:neko.dev`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:161
+#: ../../../docs/configuring-playbook-bot-draupnir.md:209
 msgid "Creating your own policy lists and rules"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:163
+#: ../../../docs/configuring-playbook-bot-draupnir.md:211
 msgid ""
 "We also recommend **creating your own policy lists** with the [list "
 "create](https://the-draupnir-project.github.io/draupnir-"
@@ -395,7 +478,7 @@ msgid ""
 "create-command-to-create-a-policy-room) command."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:165
+#: ../../../docs/configuring-playbook-bot-draupnir.md:213
 msgid ""
 "You can do so by sending the following command to the Management Room: "
 "`!draupnir list create my-bans my-bans-bl`. This will create a policy "
@@ -404,7 +487,7 @@ msgid ""
 "command, the bot will invite you to the policy list room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:167
+#: ../../../docs/configuring-playbook-bot-draupnir.md:215
 msgid ""
 "A policy list does nothing by itself, so the next step is **adding some "
 "rules to your policy list**. Policies target a so-called `entity` (one "
@@ -415,7 +498,7 @@ msgid ""
 "recommendation)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:169
+#: ../../../docs/configuring-playbook-bot-draupnir.md:217
 msgid ""
 "The simplest and most useful entity to target is `user`. Below are a few "
 "examples using the [ban command](https://the-draupnir-project.github.io"
@@ -423,19 +506,19 @@ msgid ""
 "targeting users."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:171
+#: ../../../docs/configuring-playbook-bot-draupnir.md:219
 msgid ""
 "To create rules, you run commands in the Management Room (**not** in the "
 "policy list room)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:173
+#: ../../../docs/configuring-playbook-bot-draupnir.md:221
 msgid ""
 "(ban a single user on a given homeserver): `!draupnir ban "
 "@charles:example.com my-bans Rude to others`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:174
+#: ../../../docs/configuring-playbook-bot-draupnir.md:222
 msgid ""
 "(ban all users on a given homeserver by using a [wildcard](https://the-"
 "draupnir-project.github.io/draupnir-documentation/moderator/managing-"
@@ -443,34 +526,34 @@ msgid ""
 "all users are fake`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:176
+#: ../../../docs/configuring-playbook-bot-draupnir.md:224
 msgid "As a result of running these commands, you may observe:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:178
+#: ../../../docs/configuring-playbook-bot-draupnir.md:226
 msgid ""
 "Draupnir creating `m.policy.rule.user` state events in the `#my-bans-"
 "bl:example.com` room on your server"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:179
+#: ../../../docs/configuring-playbook-bot-draupnir.md:227
 msgid ""
 "applying these rules against all rooms that Draupnir is an Administrator "
 "in"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:181
+#: ../../../docs/configuring-playbook-bot-draupnir.md:229
 msgid ""
 "You can undo bans with the [unban command](https://the-draupnir-"
 "project.github.io/draupnir-documentation/moderator/managing-users#the-"
 "unban-command)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:183
+#: ../../../docs/configuring-playbook-bot-draupnir.md:231
 msgid "Enabling built-in protections"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:185
+#: ../../../docs/configuring-playbook-bot-draupnir.md:233
 msgid ""
 "You can also **turn on various built-in [protections](https://the-"
 "draupnir-project.github.io/draupnir-documentation/protections)** like "
@@ -478,75 +561,179 @@ msgid ""
 "room to invite-only\")."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:187
+#: ../../../docs/configuring-playbook-bot-draupnir.md:235
 msgid ""
 "To **see which protections are available and which are enabled**, send a "
 "`!draupnir protections` command to the Management Room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:189
+#: ../../../docs/configuring-playbook-bot-draupnir.md:237
 msgid ""
 "To **see the configuration options for a given protection**, send a "
 "`!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get "
 "JoinWaveShortCircuit`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:191
+#: ../../../docs/configuring-playbook-bot-draupnir.md:239
 msgid ""
 "To **set a specific option for a given protection**, send a command like "
 "this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. "
 "`!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:193
+#: ../../../docs/configuring-playbook-bot-draupnir.md:241
 msgid ""
 "To **enable a given protection**, send a command like this: `!draupnir "
 "enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:195
+#: ../../../docs/configuring-playbook-bot-draupnir.md:243
 msgid ""
 "To **disable a given protection**, send a command like this: `!draupnir "
 "disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:197
-msgid "Extending the configuration"
-msgstr ""
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/the-draupnir-project/Draupnir) to learn "
+#~ "what it does and why it might "
+#~ "be useful to you."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:199
-msgid ""
-"You can configure additional options by adding the "
-"`matrix_bot_draupnir_configuration_extension_yaml` variable to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file."
-msgstr ""
+#~ msgid "If your migrating from Mjolnir skip to step 5b."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:201
-msgid ""
-"For example to change Draupnir's `recordIgnoredInvites` option to `true` "
-"you would add the following to your `vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "The playbook does not automatically "
+#~ "create users for you. The bot "
+#~ "requires an access token to be "
+#~ "able to connect to your homeserver."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:215
-msgid "Abuse Reports"
-msgstr ""
+#~ msgid ""
+#~ "You **need to register the bot "
+#~ "user manually** before setting up the"
+#~ " bot."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:217
-msgid "Draupnir supports two methods to receive reports in the management room."
-msgstr ""
+#~ msgid ""
+#~ "If you would like Draupnir to be"
+#~ " able to deactivate users, move "
+#~ "aliases, shutdown rooms, show abuse "
+#~ "reports ([see below](#abuse-reports)), etc "
+#~ "then it must be a server admin "
+#~ "so you need to change `admin=no` "
+#~ "to `admin=yes` in the command above."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:219
-msgid ""
-"The first method intercepts the report API endpoint of the client-server "
-"API, which requires integration with the reverse proxy in front of the "
-"homeserver. If you are using traefik, this playbook can set this up for "
-"you:"
-msgstr ""
+#~ msgid ""
+#~ "Refer to the documentation on [how "
+#~ "to obtain an access token](obtaining-"
+#~ "access-tokens.md)."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-draupnir.md:225
-msgid ""
-"The other method polls an synapse admin API endpoint and is hence only "
-"available when using synapse and when the Draupnir user is an admin user "
-"(see step 1). To enable it, set `pollReports: true` in Draupnir's config:"
-msgstr ""
+#~ msgid ""
+#~ "You will need to prevent Synapse "
+#~ "from rate limiting the bot's account."
+#~ " This is not an optional step. "
+#~ "If you do not do this step "
+#~ "Draupnir will crash. This can be "
+#~ "done using Synapse's [admin API](https"
+#~ "://matrix-"
+#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html"
+#~ "#override-ratelimiting-for-users). Please "
+#~ "ask for help if you are "
+#~ "uncomfortable with these steps or run"
+#~ " into issues."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If your Synapse Admin API is "
+#~ "exposed to the internet for some "
+#~ "reason like running the Synapse Admin"
+#~ " Role [Link](configuring-playbook-synapse-"
+#~ "admin.md) or running "
+#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
+#~ " true` in your playbook config. If"
+#~ " your API is not externally exposed"
+#~ " you should still be able to on"
+#~ " the local host for your synapse "
+#~ "run these commands."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The following command works on semi "
+#~ "up to date Windows 10 installs and"
+#~ " All Windows 11 installations and "
+#~ "other systems that ship curl. `curl "
+#~ "--header \"Authorization: Bearer <access_token>\""
+#~ " -X POST "
+#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`"
+#~ " Replace `@bot.draupnir:example.com` with the "
+#~ "MXID of your Draupnir and example.com"
+#~ " with your homeserver domain. You can"
+#~ " easily obtain an access token for"
+#~ " a homeserver admin account the same"
+#~ " way you can obtain an access "
+#~ "token for Draupnir itself. If you "
+#~ "made Draupnir Admin you can just "
+#~ "use the Draupnir token."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you make the management room "
+#~ "encrypted (E2EE), then you MUST enable"
+#~ " and use Pantalaimon (see below)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Decide whether you want Draupnir to "
+#~ "be capable of operating in end-"
+#~ "to-end encrypted (E2EE) rooms. This "
+#~ "includes the management room and the "
+#~ "moderated rooms. To support E2EE, "
+#~ "Draupnir needs to [use Pantalaimon"
+#~ "](configuring-playbook-pantalaimon.md)."
+#~ msgstr ""
+
+#~ msgid "a. Configuration with E2EE support"
+#~ msgstr ""
+
+#~ msgid "b. Configuration without E2EE support"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You must replace "
+#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
+#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own "
+#~ "values."
+#~ msgstr ""
+
+#~ msgid "c. Migrating from Mjolnir (Only required if migrating.)"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can configure additional options by"
+#~ " adding the "
+#~ "`matrix_bot_draupnir_configuration_extension_yaml` variable "
+#~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
+#~ " file."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For example to change Draupnir's "
+#~ "`recordIgnoredInvites` option to `true` you"
+#~ " would add the following to your "
+#~ "`vars.yml` file."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The other method polls an synapse "
+#~ "admin API endpoint and is hence "
+#~ "only available when using synapse and"
+#~ " when the Draupnir user is an "
+#~ "admin user (see step 1). To enable"
+#~ " it, set `pollReports: true` in "
+#~ "Draupnir's config:"
+#~ msgstr ""
 
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
index ea89191dd..8dbd4665d 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-go-neb.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -49,8 +49,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-go-neb.md:9
 msgid ""
-"See the project's [documentation](https://github.com/matrix-org/go-neb) "
-"to learn what it does and why it might be useful to you."
+"See the project's [documentation](https://github.com/matrix-org/go-"
+"neb/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-go-neb.md:11
@@ -207,3 +208,10 @@ msgid ""
 "/matrix-org/go-neb)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/go-neb) to learn what it"
+#~ " does and why it might be "
+#~ "useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
index a0e5ceba7..e551070dc 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-honoroit.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -36,9 +36,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-honoroit.md:7
 msgid ""
-"See the project's [documentation](https://github.com/etkecc/honoroit#how-"
-"it-looks-like) to learn what it does with screenshots and why it might be"
-" useful to you."
+"See the project's "
+"[documentation](https://github.com/etkecc/honoroit/blob/main/README.md) "
+"to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-honoroit.md:9
@@ -166,3 +166,11 @@ msgid ""
 "[documentation](https://github.com/etkecc/honoroit#features)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/etkecc/honoroit#how-it-"
+#~ "looks-like) to learn what it does "
+#~ "with screenshots and why it might "
+#~ "be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
index cc7e35bd2..fb61172cc 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-registration-bot.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -43,7 +43,7 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-matrix-registration-bot.md:7
 msgid ""
 "See the project's [documentation](https://github.com/moan0s/matrix-"
-"registration-bot#supported-commands) to learn what it does and why it "
+"registration-bot/blob/master/README.md) to learn what it does and why it "
 "might be useful to you."
 msgstr ""
 
@@ -145,3 +145,11 @@ msgid ""
 "etc… you can use:"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/moan0s/matrix-"
+#~ "registration-bot#supported-commands) to learn "
+#~ "what it does and why it might "
+#~ "be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
index 6c3e1858a..5148da31a 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-matrix-reminder-bot.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -39,8 +39,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:7
 msgid ""
 "See the project's [documentation](https://github.com/anoadragon453"
-"/matrix-reminder-bot#usage) to learn what it does and why it might be "
-"useful to you."
+"/matrix-reminder-bot/blob/master/README.md) to learn what it does and why"
+" it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-matrix-reminder-bot.md:9
@@ -133,3 +133,11 @@ msgid ""
 "bot#usage)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/anoadragon453/matrix-"
+#~ "reminder-bot#usage) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
index 7a323cbe2..cbadc9714 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-mjolnir.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -32,22 +32,23 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:5
 msgid ""
-"See the project's [documentation](https://github.com/matrix-org/mjolnir) "
-"to learn what it does and why it might be useful to you."
+"See the project's [documentation](https://github.com/matrix-"
+"org/mjolnir/blob/main/README.md) to learn what it does and why it might "
+"be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:7
-msgid "Register the bot account"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:9
-msgid ""
-"The playbook does not automatically create users for you. The bot "
-"requires an access token to be able to connect to your homeserver."
+msgid "Register the bot account"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:11
-msgid "You **need to register the bot user manually** before setting up the bot."
+msgid ""
+"The playbook does not automatically create users for you. You **need to "
+"register the bot user manually** before setting up the bot."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:13
@@ -73,8 +74,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:25
 msgid ""
-"Refer to the documentation on [how to obtain an access token](obtaining-"
-"access-tokens.md)."
+"The bot requires an access token to be able to connect to your "
+"homeserver. Refer to the documentation on [how to obtain an access token"
+"](obtaining-access-tokens.md)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:27
@@ -83,43 +85,65 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:29
 msgid ""
-"You will need to prevent Synapse from rate limiting the bot's account. "
-"This is not an optional step. If you do not do this step Mjolnir will "
-"crash. This can be done using Synapse's [admin API](https://matrix-"
-"org.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
-"ratelimiting-for-users). Please ask for help if you are uncomfortable "
-"with these steps or run into issues."
+"If your homeserver's implementation is Synapse, you will need to prevent "
+"it from rate limiting the bot's account. **This is a required step. If "
+"you do not configure it, Mjolnir will crash.**"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:31
 msgid ""
-"If your Synapse Admin API is exposed to the internet for some reason like"
-" running the Synapse Admin Role [Link](configuring-playbook-synapse-"
-"admin.md) or running "
-"`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
-" true` in your playbook config. If your API is not externally exposed you"
-" should still be able to on the local host for your synapse run these "
-"commands."
+"This can be done using Synapse's [Admin APIs](https://element-"
+"hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
+"ratelimiting-for-users). They can be accessed both externally and "
+"internally."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bot-mjolnir.md:33
 msgid ""
-"The following command works on semi up to date Windows 10 installs and "
-"All Windows 11 installations and other systems that ship curl. `curl "
-"--header \"Authorization: Bearer <access_token>\" -X POST "
-"https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`"
-" Replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir and "
-"example.com with your homeserver domain. You can easily obtain an access "
-"token for a homeserver admin account the same way you can obtain an "
-"access token for Mjolnir itself. If you made Mjolnir Admin you can just "
-"use the Mjolnir token."
+"To expose the APIs publicly, add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:35
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:39
+msgid ""
+"The APIs can also be accessed via [Synapse "
+"Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can "
+"use to administrate users, rooms, media, etc. on your Matrix server. The "
+"playbook can install and configure Synapse Admin for you. For details "
+"about it, see [this page](configuring-playbook-synapse-admin.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:41
+msgid ""
+"**Note**: access to the APIs is restricted with a valid access token, so "
+"exposing them publicly should not be a real security concern. Still, "
+"doing so is not recommended for additional security. See [official "
+"Synapse reverse-proxying recommendations](https://element-"
+"hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
+"endpoints)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:43
+msgid ""
+"To discharge rate limiting, run the following command on systems that "
+"ship curl (note that it does not work on outdated Windows 10). Even if "
+"the APIs are not exposed to the internet, you should still be able to run"
+" the command on the homeserver locally. Before running it, make sure to "
+"replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:49
+msgid ""
+"You can obtain an access token for a homeserver admin account in the same"
+" way as you can do so for Mjolnir itself. If you have made Mjolnir an "
+"admin, you can just use the Mjolnir token."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:51
 msgid "Create a management room"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:37
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:53
 msgid ""
 "Using your own account, create a new invite only room that you will use "
 "to manage the bot. This is the room where you will see the status of the "
@@ -128,13 +152,13 @@ msgid ""
 "it is important that you only invite trusted users to this room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:39
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:55
 msgid ""
 "If you make the management room encrypted (E2EE), then you MUST enable "
-"and use Pantalaimon (see below)."
+"and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:41
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:57
 msgid ""
 "Once you have created the room you need to copy the room ID so you can "
 "tell the bot to use that room. In Element Web you can do this by going to"
@@ -142,44 +166,58 @@ msgid ""
 "room ID. The room ID will look something like `!qporfwt:example.com`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:43
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:59
 msgid ""
 "Finally invite the `@bot.mjolnir:example.com` account you created earlier"
 " into the room."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:45
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:61
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:47
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:63
+msgid ""
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `MANAGEMENT_ROOM_ID_HERE`."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:72
+msgid "End-to-End Encryption support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:74
 msgid ""
 "Decide whether you want Mjolnir to be capable of operating in end-to-end "
 "encrypted (E2EE) rooms. This includes the management room and the "
-"moderated rooms. To support E2EE, Mjolnir needs to [use Pantalaimon"
-"](configuring-playbook-pantalaimon.md)."
+"moderated rooms."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:49
-msgid "a. Configuration with E2EE support"
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:76
+msgid ""
+"To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-"
+"pantalaimon.md)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:51
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:78
+msgid "Configuration with E2EE support"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:80
 msgid ""
 "When using Pantalaimon, Mjolnir will log in to its bot account itself "
 "through Pantalaimon, so configure its username and password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:53
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:88
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:102
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:82
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:72
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:96
 msgid ""
 "The playbook's `group_vars` will configure other required settings. If "
 "using this role separately without the playbook, you also need to "
@@ -188,53 +226,80 @@ msgid ""
 "playbook's `group_vars`:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:84
-msgid "b. Configuration without E2EE support"
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:108
+msgid "Configuration without E2EE support"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:86
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:110
 msgid ""
 "When NOT using Pantalaimon, Mjolnir does not log in by itself and you "
 "must give it an access token for its bot account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:90
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:112
 msgid ""
-"You must replace `ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
-"`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own values."
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
+"token)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:100
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:118
 msgid "Adding Mjolnir synapse antispam module (optional)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:112
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:120
+msgid ""
+"To enable Mjolnir synapse antispam module, add the following "
+"configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
+"file (adapt to your needs):"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:130
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:132
+msgid ""
+"You can configure additional options by adding the "
+"`matrix_bot_mjolnir_configuration_extension_yaml` variable to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:134
+msgid ""
+"For example, to change Mjolnir's `recordIgnoredInvites` option to `true`,"
+" add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:148
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:114
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:150
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:121
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:157
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:123
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:159
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:125
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:161
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:127
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:163
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -243,7 +308,7 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:129
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:165
 msgid ""
 "If you change the Pantalaimon's password "
 "(`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) "
@@ -254,11 +319,11 @@ msgid ""
 "know its new password."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:131
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:167
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:133
+#: ../../../docs/configuring-playbook-bot-mjolnir.md:169
 msgid ""
 "You can refer to the upstream [documentation](https://github.com/matrix-"
 "org/mjolnir) for additional ways to use and configure Mjolnir. Check out "
@@ -266,16 +331,113 @@ msgid ""
 "#quickstart-guide) for some basic commands you can give to the bot."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:135
-msgid ""
-"You can configure additional options by adding the "
-"`matrix_bot_mjolnir_configuration_extension_yaml` variable to your "
-"`inventory/host_vars/matrix.example.com/vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/mjolnir) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
 
-#: ../../../docs/configuring-playbook-bot-mjolnir.md:137
-msgid ""
-"For example to change Mjolnir's `recordIgnoredInvites` option to `true` "
-"you would add the following to your `vars.yml` file."
-msgstr ""
+#~ msgid ""
+#~ "The playbook does not automatically "
+#~ "create users for you. The bot "
+#~ "requires an access token to be "
+#~ "able to connect to your homeserver."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You **need to register the bot "
+#~ "user manually** before setting up the"
+#~ " bot."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Refer to the documentation on [how "
+#~ "to obtain an access token](obtaining-"
+#~ "access-tokens.md)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You will need to prevent Synapse "
+#~ "from rate limiting the bot's account."
+#~ " This is not an optional step. "
+#~ "If you do not do this step "
+#~ "Mjolnir will crash. This can be "
+#~ "done using Synapse's [admin API](https"
+#~ "://matrix-"
+#~ "org.github.io/synapse/latest/admin_api/user_admin_api.html"
+#~ "#override-ratelimiting-for-users). Please "
+#~ "ask for help if you are "
+#~ "uncomfortable with these steps or run"
+#~ " into issues."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If your Synapse Admin API is "
+#~ "exposed to the internet for some "
+#~ "reason like running the Synapse Admin"
+#~ " Role [Link](configuring-playbook-synapse-"
+#~ "admin.md) or running "
+#~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
+#~ " true` in your playbook config. If"
+#~ " your API is not externally exposed"
+#~ " you should still be able to on"
+#~ " the local host for your synapse "
+#~ "run these commands."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The following command works on semi "
+#~ "up to date Windows 10 installs and"
+#~ " All Windows 11 installations and "
+#~ "other systems that ship curl. `curl "
+#~ "--header \"Authorization: Bearer <access_token>\""
+#~ " -X POST "
+#~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`"
+#~ " Replace `@bot.mjolnir:example.com` with the "
+#~ "MXID of your Mjolnir and example.com "
+#~ "with your homeserver domain. You can "
+#~ "easily obtain an access token for "
+#~ "a homeserver admin account the same "
+#~ "way you can obtain an access token"
+#~ " for Mjolnir itself. If you made "
+#~ "Mjolnir Admin you can just use the"
+#~ " Mjolnir token."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you make the management room "
+#~ "encrypted (E2EE), then you MUST enable"
+#~ " and use Pantalaimon (see below)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Decide whether you want Mjolnir to "
+#~ "be capable of operating in end-"
+#~ "to-end encrypted (E2EE) rooms. This "
+#~ "includes the management room and the "
+#~ "moderated rooms. To support E2EE, "
+#~ "Mjolnir needs to [use Pantalaimon"
+#~ "](configuring-playbook-pantalaimon.md)."
+#~ msgstr ""
+
+#~ msgid "a. Configuration with E2EE support"
+#~ msgstr ""
+
+#~ msgid "b. Configuration without E2EE support"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You must replace "
+#~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
+#~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own "
+#~ "values."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For example to change Mjolnir's "
+#~ "`recordIgnoredInvites` option to `true` you"
+#~ " would add the following to your "
+#~ "`vars.yml` file."
+#~ msgstr ""
 
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
index 0cc472964..39afd04fa 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-appservice-kakaotalk.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -44,8 +44,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:7
 msgid ""
 "See the project's [documentation](https://src.miscworks.net/fair/matrix-"
-"appservice-kakaotalk) to learn what it does and why it might be useful to"
-" you."
+"appservice-kakaotalk/src/branch/master/README.md) to learn what it does "
+"and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-appservice-kakaotalk.md:9
@@ -227,3 +227,11 @@ msgid ""
 "in the future, as that would break the Double Puppeting feature"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://src.miscworks.net/fair/matrix-"
+#~ "appservice-kakaotalk) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
index 7973bfcd1..ce60bf716 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-go-skype-bridge.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -32,8 +32,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/kelaresg/go-skype-"
+"bridge/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-go-skype-bridge.md:7
@@ -97,3 +98,9 @@ msgstr ""
 msgid "Send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po
index 392e7645b..86ee04111 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-heisenbridge.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -42,9 +42,9 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-heisenbridge.md:7
 msgid ""
 "See the project's "
-"[README](https://github.com/hifi/heisenbridge/blob/master/README.md) to "
-"learn what it does and why it might be useful to you. You can also take a"
-" look at [this demonstration "
+"[documentation](https://github.com/hifi/heisenbridge/blob/master/README.md)"
+" to learn what it does and why it might be useful to you. You can also "
+"take a look at [this demonstration "
 "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
 msgstr ""
 
@@ -182,3 +182,13 @@ msgid ""
 "[#heisenbridge:vi.fi](https://matrix.to/#/#heisenbridge:vi.fi) for help."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[README](https://github.com/hifi/heisenbridge/blob/master/README.md)"
+#~ " to learn what it does and why"
+#~ " it might be useful to you. You"
+#~ " can also take a look at [this"
+#~ " demonstration "
+#~ "video](https://www.youtube.com/watch?v=nQk1Bp4tk4I)."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
index 3e2ad96e1..14ef06275 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-hookshot.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -33,15 +33,15 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:5
 msgid ""
 "Hookshot can bridge [Webhooks](https://en.wikipedia.org/wiki/Webhook) "
-"from software project management services such as GitHub, GitLab, JIRA, "
+"from software project management services such as GitHub, GitLab, Jira, "
 "and Figma, as well as generic webhooks."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:7
 msgid ""
 "See the project's [documentation](https://matrix-org.github.io/matrix-"
-"hookshot/latest/hookshot.html) to learn what it does in detail and why it"
-" might be useful to you."
+"hookshot/latest/hookshot.html) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:9
@@ -52,152 +52,172 @@ msgid ""
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:11
-msgid "Setup Instructions"
+msgid "Prerequisites"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:13
-msgid ""
-"Refer to the [official instructions](https://matrix-org.github.io/matrix-"
-"hookshot/latest/setup.html) to learn what the individual options do."
+msgid "Download GitHub app private key (optional)"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:15
 msgid ""
-"Enable the bridge by adding `matrix_hookshot_enabled: true` to your "
-"`vars.yml` file"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:16
-msgid ""
-"For each of the services (GitHub, GitLab, Jira, Figma, generic webhooks) "
-"fill in the respective variables `matrix_hookshot_service_*` listed in "
-"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) as "
-"required."
+"If you're setting up the GitHub bridge, you need to create your GitHub "
+"app, and generate a private key file of it."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:17
 msgid ""
-"Take special note of the `matrix_hookshot_*_enabled` variables. Services "
-"that need no further configuration are enabled by default (GitLab, "
-"Generic), while you must first add the required configuration and enable "
-"the others (GitHub, Jira, Figma)."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:18
-msgid ""
-"If you're setting up the GitHub bridge, you'll need to generate and "
-"download a private key file after you created your GitHub app. Copy the "
-"contents of that file to the variable "
-"`matrix_hookshot_github_private_key` so the playbook can install it for "
-"you, or use one of the [other methods](#manage-github-private-key-with-"
-"aux-role) explained below."
+"You need to download the private key file, if you will install the file "
+"manually or with the `aux` role. For details, see [the section below"
+"](#manage-github-private-key-with-aux-role)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:19
-msgid ""
-"If you've already installed Matrix services using the playbook before, "
-"you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with"
-" [configuring other playbook services](configuring-playbook.md) and then "
-"with [Installing](installing.md). Get back to this guide once ready. "
-"Hookshot can be set up individually using the tag `setup-hookshot`."
+msgid "Adjusting the playbook configuration"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md:21
 msgid ""
-"Other configuration options are available via the "
+"Add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
+"replace `GITHUB_PRIVATE_KEY_HERE` with the one created [above](#download-"
+"github-app-private-key)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:35
+msgid ""
+"For each of the services (GitHub, GitLab, Jira, Figma, and generic "
+"webhooks) fill in the respective variables `matrix_hookshot_service_*` "
+"listed in [main.yml](../roles/custom/matrix-bridge-"
+"hookshot/defaults/main.yml) as required."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:37
+msgid ""
+"Take special note of the `matrix_hookshot_*_enabled` variables. Services "
+"that need no further configuration are enabled by default (GitLab and "
+"generic webhooks), while you must first add the required configuration "
+"and enable the others (GitHub, Jira, and Figma)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:39
+msgid "Extending the configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:41
+msgid ""
+"You can configure additional options by adding the "
 "`matrix_hookshot_configuration_extension_yaml` and "
-"`matrix_hookshot_registration_extension_yaml` variables, see the comments"
-" in [main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml) "
-"for how to use them."
+"`matrix_hookshot_registration_extension_yaml` variables."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:23
-msgid "Finally, run the playbook (see [installing](installing.md))."
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:25
-msgid "End-to-bridge encryption"
-msgstr ""
-
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:27
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
 msgid ""
-"You can enable [encryption](https://matrix-org.github.io/matrix-"
-"hookshot/latest/advanced/encryption.html) for Hookshot by adding "
-"`matrix_hookshot_encryption_enabled: true` to your configuration "
-"(`vars.yml`) and [executing the playbook](installing.md) again."
+"Refer the [official instructions](https://matrix-org.github.io/matrix-"
+"hookshot/latest/setup.html) and the comments in "
+"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml) to "
+"learn what the individual options do."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:29
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:45
+msgid "Installing"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
 msgid ""
-"Should the crypto store be corrupted, you can reset it by executing this "
-"Ansible playbook with the tag `reset-hookshot-encryption` added, for "
-"example `ansible-playbook -i inventory/hosts setup.yml --tags=reset-"
-"hookshot-encryption`."
+"After configuring the playbook, run it with [playbook tags](playbook-"
+"tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:31
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:54
+msgid ""
+"The shortcut commands with the [`just` program](just.md) are also "
+"available: `just install-service hookshot` or `just setup-all`"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:56
+msgid ""
+"`just install-service hookshot` is useful for maintaining your setup "
+"quickly when its components remain unchanged. If you adjust your "
+"`vars.yml` to remove other components, you'd need to run `just setup-"
+"all`, or these components will still remain installed. Note `just setup-"
+"all` runs the `ensure-matrix-users-created` tag too."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:58
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:33
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:60
 msgid ""
 "To use the bridge, you need to create a room and invite the Hookshot bot "
 "(`@hookshot:example.com`) to it."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:35
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:62
 msgid ""
 "Make sure the bot is able to send state events (usually the Moderator "
 "power level in clients)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:37
-msgid "Send a `!hookshot help` message to see a list of help commands."
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:64
+msgid ""
+"Send `!hookshot help` to the room to see the bridge's help menu for "
+"additional commands."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:39
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:66
 msgid ""
 "Refer to [Hookshot's documentation](https://matrix-org.github.io/matrix-"
 "hookshot/latest/usage.html) for more details about using the bridge's "
 "various features."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:41
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:68
 msgid ""
-"**Important**: Note that the different listeners are bound to certain "
-"paths which might differ from those assumed by the hookshot "
-"documentation, see [URLs for bridges setup](#urls-for-bridges-setup) "
-"below."
+"💡 **Note**: the different listeners are bound to certain paths which "
+"might differ from those assumed by the hookshot documentation. See [URLs "
+"for bridges setup](#urls-for-bridges-setup) below."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:43
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:70
+msgid "Reset crypto store"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:72
+msgid ""
+"Should the crypto store be corrupted, you can reset it by executing this "
+"Ansible playbook with the tag `reset-hookshot-encryption` added:"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:78
 msgid "More setup documentation"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:45
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:80
 msgid "URLs for bridges setup"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:47
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:82
 msgid ""
 "Unless indicated otherwise, the following endpoints are reachable on your"
 " `matrix.` subdomain (if the feature is enabled)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "listener"
+msgid "Listener"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "default path"
+msgid "Default path"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "variable"
+msgid "Variable"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "used as"
+msgid "Used as"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
@@ -261,7 +281,7 @@ msgid "`matrix_hookshot_jira_oauth_endpoint`"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
-msgid "JIRA OAuth"
+msgid "Jira OAuth"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-hookshot.md
@@ -348,71 +368,72 @@ msgstr ""
 msgid "Prometheus"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:61
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:96
 msgid ""
 "Also see the various `matrix_hookshot_container_labels_*` variables in "
-"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml), which"
-" expose URLs publicly."
+"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml), "
+"which expose URLs publicly"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:63
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:98
 msgid ""
 "The different listeners are also reachable *internally* in the docker-"
 "network via the container's name (configured by "
 "`matrix_hookshot_container_url`) and on different ports (e.g. "
-"`matrix_hookshot_appservice_port`). Read [main.yml](/roles/custom/matrix-"
-"bridge-hookshot/defaults/main.yml) in detail for more info."
+"`matrix_hookshot_appservice_port`). Read [main.yml](../roles/custom"
+"/matrix-bridge-hookshot/defaults/main.yml) in detail for more info."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:65
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
 msgid "Manage GitHub Private Key with aux role"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:67
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:102
 msgid ""
 "The GitHub bridge requires you to install a private key file. This can be"
 " done in multiple ways:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:68
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:104
 msgid ""
 "copy the *contents* of the downloaded file and set the variable "
 "`matrix_hookshot_github_private_key` to the contents (see example in "
-"[main.yml](/roles/custom/matrix-bridge-hookshot/defaults/main.yml))."
+"[main.yml](../roles/custom/matrix-bridge-hookshot/defaults/main.yml))."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:69
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:105
 msgid ""
 "somehow copy the file to the path `{{ matrix_hookshot_base_path }}/{{ "
 "matrix_hookshot_github_private_key_file }}` (default: `/matrix/hookshot"
 "/private-key.pem`) on the server manually."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:70
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:106
 msgid ""
 "use the [`aux` role](https://github.com/mother-of-all-self-hosting"
 "/ansible-role-aux) to copy the file from an arbitrary path on your "
 "ansible client to the correct path on the server."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:72
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:108
 msgid ""
 "To use the `aux` role, make sure the `matrix_hookshot_github_private_key`"
-" variable is empty. Then add the following additional configuration:"
+" variable is empty. Then add the following configuration to your "
+"`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:83
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:119
 msgid ""
 "For more information, see the documentation in the [default configuration"
 " of the aux role](https://github.com/mother-of-all-self-hosting/ansible-"
 "role-aux/blob/main/defaults/main.yml)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:85
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:121
 msgid "Provisioning API"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:87
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:123
 msgid ""
 "The provisioning API will be enabled automatically if you set "
 "`matrix_dimension_enabled: true` and provided a "
@@ -422,11 +443,11 @@ msgid ""
 "`matrix_hookshot_container_url` and `matrix_hookshot_provisioning_port`."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:89
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:125
 msgid "Metrics"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:91
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:127
 msgid ""
 "Metrics are **only enabled by default** if the builtin [Prometheus"
 "](configuring-playbook-prometheus-grafana.md) is enabled (by default, "
@@ -435,32 +456,32 @@ msgid ""
 "set up your own Dashboard for displaying them."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:93
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:129
 msgid ""
 "To explicitly enable metrics, use `matrix_hookshot_metrics_enabled: "
 "true`. This only exposes metrics over the container network, however."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:95
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:131
 msgid ""
 "**To collect metrics from an external Prometheus server**, besides "
 "enabling metrics as described above, you will also need to enable metrics"
 " exposure on `https://matrix.example.com/metrics/hookshot` by:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:97
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:133
 msgid ""
 "either enabling metrics exposure for Hookshot via "
 "`matrix_hookshot_metrics_proxying_enabled: true`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:98
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:134
 msgid ""
 "or enabling metrics exposure for all services via "
 "`matrix_metrics_exposure_enabled: true`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:100
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:136
 msgid ""
 "Whichever one you go with, by default metrics are exposed publicly "
 "**without** password-protection. See [the Prometheus and Grafana docs"
@@ -468,11 +489,11 @@ msgid ""
 "protection for metrics."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:102
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:138
 msgid "Collision with matrix-appservice-webhooks"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-hookshot.md:104
+#: ../../../docs/configuring-playbook-bridge-hookshot.md:140
 msgid ""
 "If you are also running [matrix-appservice-webhooks](configuring-"
 "playbook-bridge-appservice-webhooks.md), it reserves its namespace by the"
@@ -482,3 +503,175 @@ msgid ""
 "`matrix_hookshot_generic_userIdPrefix: '_webhooks_'`)."
 msgstr ""
 
+#~ msgid ""
+#~ "Hookshot can bridge "
+#~ "[Webhooks](https://en.wikipedia.org/wiki/Webhook) from "
+#~ "software project management services such "
+#~ "as GitHub, GitLab, JIRA, and Figma, "
+#~ "as well as generic webhooks."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "See the project's [documentation](https://matrix-"
+#~ "org.github.io/matrix-hookshot/latest/hookshot.html) to "
+#~ "learn what it does in detail and"
+#~ " why it might be useful to you."
+#~ msgstr ""
+
+#~ msgid "Setup Instructions"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Refer to the [official instructions](https"
+#~ "://matrix-org.github.io/matrix-hookshot/latest/setup.html)"
+#~ " to learn what the individual options"
+#~ " do."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Enable the bridge by adding "
+#~ "`matrix_hookshot_enabled: true` to your "
+#~ "`vars.yml` file"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For each of the services (GitHub, "
+#~ "GitLab, Jira, Figma, generic webhooks) "
+#~ "fill in the respective variables "
+#~ "`matrix_hookshot_service_*` listed in "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml) as required."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Take special note of the "
+#~ "`matrix_hookshot_*_enabled` variables. Services that"
+#~ " need no further configuration are "
+#~ "enabled by default (GitLab, Generic), "
+#~ "while you must first add the "
+#~ "required configuration and enable the "
+#~ "others (GitHub, Jira, Figma)."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you're setting up the GitHub "
+#~ "bridge, you'll need to generate and "
+#~ "download a private key file after "
+#~ "you created your GitHub app. Copy "
+#~ "the contents of that file to the"
+#~ " variable `matrix_hookshot_github_private_key` so "
+#~ "the playbook can install it for "
+#~ "you, or use one of the [other "
+#~ "methods](#manage-github-private-key-with-"
+#~ "aux-role) explained below."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you've already installed Matrix "
+#~ "services using the playbook before, "
+#~ "you'll need to re-run it (`--tags"
+#~ "=setup-all,start`). If not, proceed with"
+#~ " [configuring other playbook services"
+#~ "](configuring-playbook.md) and then with "
+#~ "[Installing](installing.md). Get back to this"
+#~ " guide once ready. Hookshot can be"
+#~ " set up individually using the tag"
+#~ " `setup-hookshot`."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Other configuration options are available "
+#~ "via the `matrix_hookshot_configuration_extension_yaml` "
+#~ "and `matrix_hookshot_registration_extension_yaml` "
+#~ "variables, see the comments in "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml) for how to use "
+#~ "them."
+#~ msgstr ""
+
+#~ msgid "Finally, run the playbook (see [installing](installing.md))."
+#~ msgstr ""
+
+#~ msgid "End-to-bridge encryption"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can enable [encryption](https://matrix-"
+#~ "org.github.io/matrix-hookshot/latest/advanced/encryption.html)"
+#~ " for Hookshot by adding "
+#~ "`matrix_hookshot_encryption_enabled: true` to your"
+#~ " configuration (`vars.yml`) and [executing "
+#~ "the playbook](installing.md) again."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Should the crypto store be corrupted,"
+#~ " you can reset it by executing "
+#~ "this Ansible playbook with the tag "
+#~ "`reset-hookshot-encryption` added, for "
+#~ "example `ansible-playbook -i inventory/hosts"
+#~ " setup.yml --tags=reset-hookshot-encryption`."
+#~ msgstr ""
+
+#~ msgid "Send a `!hookshot help` message to see a list of help commands."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "**Important**: Note that the different "
+#~ "listeners are bound to certain paths "
+#~ "which might differ from those assumed"
+#~ " by the hookshot documentation, see "
+#~ "[URLs for bridges setup](#urls-for-"
+#~ "bridges-setup) below."
+#~ msgstr ""
+
+#~ msgid "listener"
+#~ msgstr ""
+
+#~ msgid "default path"
+#~ msgstr ""
+
+#~ msgid "variable"
+#~ msgstr ""
+
+#~ msgid "used as"
+#~ msgstr ""
+
+#~ msgid "JIRA OAuth"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Also see the various "
+#~ "`matrix_hookshot_container_labels_*` variables in "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml), which expose URLs "
+#~ "publicly."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The different listeners are also "
+#~ "reachable *internally* in the docker-"
+#~ "network via the container's name "
+#~ "(configured by `matrix_hookshot_container_url`) and"
+#~ " on different ports (e.g. "
+#~ "`matrix_hookshot_appservice_port`). Read "
+#~ "[main.yml](/roles/custom/matrix-bridge-"
+#~ "hookshot/defaults/main.yml) in detail for more"
+#~ " info."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "copy the *contents* of the downloaded"
+#~ " file and set the variable "
+#~ "`matrix_hookshot_github_private_key` to the contents"
+#~ " (see example in [main.yml](/roles/custom"
+#~ "/matrix-bridge-hookshot/defaults/main.yml))."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "To use the `aux` role, make sure"
+#~ " the `matrix_hookshot_github_private_key` variable "
+#~ "is empty. Then add the following "
+#~ "additional configuration:"
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po
index b9ffa1e42..3ee8066a8 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-matrix-bridge-sms.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -32,8 +32,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/benkuly/matrix-sms-"
+"bridge/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-matrix-bridge-sms.md:7
@@ -98,3 +99,9 @@ msgid ""
 "bridge/blob/master/README.md#user-guide) to see how this bridge works."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
index 1e8109cd3..badc8ae74 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-twitter.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -39,8 +39,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:7
 msgid ""
-"See the project's [documentation](https://github.com/mautrix/twitter) to "
-"learn what it does and why it might be useful to you."
+"See the project's "
+"[documentation](https://github.com/mautrix/twitter/blob/master/README.md)"
+" to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:9
@@ -48,58 +49,61 @@ msgid "Prerequisite (optional)"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:11
+msgid "Enable Appservice Double Puppet (optional)"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13
 msgid ""
 "If you want to set up [Double "
 "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
 "(hint: you most likely do) for this bridge automatically, you need to "
 "have enabled [Appservice Double Puppet](configuring-playbook-appservice-"
-"double-puppet.md) or [Shared Secret Auth](configuring-playbook-shared-"
-"secret-auth.md) service for this playbook."
+"double-puppet.md) service for this playbook."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:13
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15
 msgid ""
 "For details about configuring Double Puppeting for this bridge, see the "
 "section below: [Set up Double Puppeting](#-set-up-double-puppeting)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:15
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:17
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:19
 msgid ""
 "To enable the bridge, add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:23
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:25
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:27
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:32
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:34
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36
 msgid ""
 "The `ensure-matrix-users-created` playbook tag makes the playbook "
 "automatically create the bot's user account."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:36
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just install-all` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:38
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40
 msgid ""
 "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
 "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
@@ -108,71 +112,60 @@ msgid ""
 "`just setup-all`, or these components will still remain installed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:40
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42
 msgid "Usage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:42
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:44
 msgid ""
 "You then need to start a chat with `@twitterbot:example.com` (where "
 "`example.com` is your base domain, not the `matrix.` domain)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:43
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45
 msgid ""
 "Send login-cookie to start the login. The bot should respond with "
 "instructions on how to proceed."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:45
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47
 msgid ""
 "You can learn more here about authentication from the bridge's [official "
 "documentation on "
 "Authentication](https://docs.mau.fi/bridges/python/twitter/authentication.html)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:47
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49
 msgid "💡 Set up Double Puppeting"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:49
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51
 msgid ""
 "After successfully enabling bridging, you may wish to set up [Double "
 "Puppeting](https://docs.mau.fi/bridges/general/double-puppeting.html) "
 "(hint: you most likely do)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:51
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53
 msgid "To set it up, you have 2 ways of going about it."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:53
-msgid ""
-"Method 1: automatically, by enabling Appservice Double Puppet or Shared "
-"Secret Auth"
-msgstr ""
-
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:55
-msgid ""
-"The bridge automatically performs Double Puppeting if [Appservice Double "
-"Puppet](configuring-playbook-appservice-double-puppet.md) or [Shared "
-"Secret Auth](configuring-playbook-shared-secret-auth.md) service is "
-"configured and enabled on the server for this playbook."
+msgid "Method 1: automatically, by enabling Appservice Double Puppet"
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:57
 msgid ""
-"Enabling [Appservice Double Puppet](configuring-playbook-appservice-"
-"double-puppet.md) is the recommended way of setting up Double Puppeting, "
-"as it's easier to accomplish, works for all your users automatically, and"
-" has less of a chance of breaking in the future."
+"The bridge automatically performs Double Puppeting if [Appservice Double "
+"Puppet](configuring-playbook-appservice-double-puppet.md) service is "
+"configured and enabled on the server for this playbook."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:59
 msgid ""
-"Enabling double puppeting by enabling the [Shared Secret Auth"
-"](configuring-playbook-shared-secret-auth.md) service works at the time "
-"of writing, but is deprecated and will stop working in the future."
+"This is the recommended way of setting up Double Puppeting, as it's "
+"easier to accomplish, works for all your users automatically, and has "
+"less of a chance of breaking in the future."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:61
@@ -181,9 +174,88 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:63
 msgid ""
-"This method is currently not available for the Mautrix-Twitter bridge, "
-"but is on the "
-"[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md) "
-"under Misc/Manual login with `login-matrix`"
+"When using this method, **each user** that wishes to enable Double "
+"Puppeting needs to follow the following steps:"
 msgstr ""
 
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:65
+msgid ""
+"retrieve a Matrix access token for yourself. Refer to the documentation "
+"on [how to do that](obtaining-access-tokens.md)."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:67
+msgid ""
+"send the access token to the bot. Example: `login-matrix "
+"MATRIX_ACCESS_TOKEN_HERE`"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-bridge-mautrix-twitter.md:69
+msgid ""
+"make sure you don't log out the `Mautrix-Slack` device some time in the "
+"future, as that would break the Double Puppeting feature"
+msgstr ""
+
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/mautrix/twitter) to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you want to set up [Double "
+#~ "Puppeting](https://docs.mau.fi/bridges/general/double-"
+#~ "puppeting.html) (hint: you most likely "
+#~ "do) for this bridge automatically, you"
+#~ " need to have enabled [Appservice "
+#~ "Double Puppet](configuring-playbook-appservice-"
+#~ "double-puppet.md) or [Shared Secret Auth"
+#~ "](configuring-playbook-shared-secret-auth.md) "
+#~ "service for this playbook."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Method 1: automatically, by enabling "
+#~ "Appservice Double Puppet or Shared "
+#~ "Secret Auth"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The bridge automatically performs Double "
+#~ "Puppeting if [Appservice Double Puppet"
+#~ "](configuring-playbook-appservice-double-"
+#~ "puppet.md) or [Shared Secret Auth"
+#~ "](configuring-playbook-shared-secret-auth.md) "
+#~ "service is configured and enabled on "
+#~ "the server for this playbook."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Enabling [Appservice Double Puppet](configuring-"
+#~ "playbook-appservice-double-puppet.md) is "
+#~ "the recommended way of setting up "
+#~ "Double Puppeting, as it's easier to "
+#~ "accomplish, works for all your users "
+#~ "automatically, and has less of a "
+#~ "chance of breaking in the future."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Enabling double puppeting by enabling "
+#~ "the [Shared Secret Auth](configuring-"
+#~ "playbook-shared-secret-auth.md) service "
+#~ "works at the time of writing, but"
+#~ " is deprecated and will stop working"
+#~ " in the future."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "This method is currently not available"
+#~ " for the Mautrix-Twitter bridge, but"
+#~ " is on the "
+#~ "[roadmap](https://github.com/mautrix/twitter/blob/master/ROADMAP.md)"
+#~ " under Misc/Manual login with `login-"
+#~ "matrix`"
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po
index 673a7908b..16822cbfc 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mautrix-wsproxy.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -35,8 +35,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:5
 msgid ""
 "See the project's "
-"[documentation](https://github.com/mautrix/wsproxy#readme) to learn what "
-"it does and why it might be useful to you."
+"[documentation](https://github.com/mautrix/wsproxy/blob/master/README.md)"
+" to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mautrix-wsproxy.md:7
@@ -143,3 +143,10 @@ msgid ""
 "running `android-sms` and/or `matrix-imessage` on your device(s)."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/mautrix/wsproxy#readme) to"
+#~ " learn what it does and why it"
+#~ " might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
index ee082570c..715823a51 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-discord.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -54,8 +54,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:9
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://gitlab.com/mx-puppet/discord"
+"/mx-puppet-discord/blob/master/README.md) to learn what it does and why "
+"it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-discord.md:11
@@ -137,3 +138,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
index 0e89d39f8..4381c17cf 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-groupme.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -33,8 +33,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://gitlab.com/xangelix-pub/matrix"
+"/mx-puppet-groupme/blob/master/README.md) to learn what it does and why "
+"it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-groupme.md:7
@@ -121,3 +122,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
index 02d3399ae..80130e822 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-slack.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -44,8 +44,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:7
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://gitlab.com/mx-puppet/slack/mx-"
+"puppet-slack/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-slack.md:9
@@ -138,3 +139,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
index 46bb77cc2..e95f4c70a 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-steam.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -32,8 +32,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/icewind1991/mx-"
+"puppet-steam/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-steam.md:7
@@ -114,3 +115,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
index 4e21b4966..1583475ca 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-mx-puppet-twitter.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -39,8 +39,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:7
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/Sorunome/mx-puppet-"
+"twitter/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-mx-puppet-twitter.md:9
@@ -128,3 +129,9 @@ msgstr ""
 msgid "Also send `help` to the bot to see the commands available."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
index c70b924fd..7bc3831ab 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-postmoogle.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -45,8 +45,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-postmoogle.md:9
 msgid ""
-"See the project's [documentation](https://github.com/etkecc/postmoogle) "
-"to learn what it does and why it might be useful to you."
+"See the project's "
+"[documentation](https://github.com/etkecc/postmoogle/blob/master/README.md)"
+" to learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-postmoogle.md:11
@@ -195,3 +196,10 @@ msgid ""
 " it to `DEBUG` with the following additional configuration:"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/etkecc/postmoogle) to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po
index 9adff616c..6fd0059f3 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bridge-wechat.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -33,8 +33,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-wechat.md:5
 msgid ""
-"See the project page to learn what it does and why it might be useful to "
-"you."
+"See the project's [documentation](https://github.com/duo/matrix-"
+"wechat/blob/master/README.md) to learn what it does and why it might be "
+"useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-bridge-wechat.md:7
@@ -96,3 +97,9 @@ msgstr ""
 msgid "Send `help` to the bot to see the available commands."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project page to learn what"
+#~ " it does and why it might be"
+#~ " useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
index dfac1cb02..8b73bae84 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-email2matrix.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -226,33 +226,59 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-email2matrix.md:87
 msgid ""
-"To enable Email2Matrix, run the playbook with [playbook tags](playbook-"
+"After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:93
+#: ../../../docs/configuring-playbook-email2matrix.md:94
 msgid "**Notes**:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:95
+#: ../../../docs/configuring-playbook-email2matrix.md:96
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
-"available: `just run-tags setup-email2matrix,start` or `just setup-all`"
+"available: `just install-service email2matrix` or `just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:97
+#: ../../../docs/configuring-playbook-email2matrix.md:98
 msgid ""
-"`just run-tags setup-email2matrix,start` is useful for maintaining your "
-"setup quickly when its components remain unchanged. If you adjust your "
+"`just install-service email2matrix` is useful for maintaining your setup "
+"quickly when its components remain unchanged. If you adjust your "
 "`vars.yml` to remove other components, you'd need to run `just setup-"
 "all`, or these components will still remain installed. Note `just setup-"
 "all` runs the `ensure-matrix-users-created` tag too."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-email2matrix.md:99
+#: ../../../docs/configuring-playbook-email2matrix.md:100
 msgid ""
 "After installation, you may wish to send a test email to the email "
 "address assigned to `mailbox1` (default: `mailbox1@matrix.example.com`) "
 "to make sure that Email2Matrix works as expected."
 msgstr ""
 
+#~ msgid ""
+#~ "To enable Email2Matrix, run the playbook"
+#~ " with [playbook tags](playbook-tags.md) as"
+#~ " below:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The shortcut commands with the [`just`"
+#~ " program](just.md) are also available: "
+#~ "`just run-tags setup-email2matrix,start` "
+#~ "or `just setup-all`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "`just run-tags setup-email2matrix,start` "
+#~ "is useful for maintaining your setup "
+#~ "quickly when its components remain "
+#~ "unchanged. If you adjust your `vars.yml`"
+#~ " to remove other components, you'd "
+#~ "need to run `just setup-all`, or"
+#~ " these components will still remain "
+#~ "installed. Note `just setup-all` runs"
+#~ " the `ensure-matrix-users-created` "
+#~ "tag too."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po
index a02b8c7dd..49d8e8fe4 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ldap-auth.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -35,8 +35,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-ldap-auth.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you."
+"See the project's [documentation](https://github.com/matrix-org/matrix-"
+"synapse-ldap3/blob/main/README.rst) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-ldap-auth.md:7
@@ -81,3 +82,9 @@ msgid ""
 "](configuring-playbook-matrix-ldap-registration-proxy.md)."
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po
index c716e47a8..fd9b19f79 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-ma1sd.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -52,8 +52,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-ma1sd.md:9
 msgid ""
-"See the project's [documentation](https://github.com/ma1uta/ma1sd) to "
-"learn what it does and why it might be useful to you."
+"See the project's "
+"[documentation](https://github.com/ma1uta/ma1sd/blob/master/README.md) to"
+" learn what it does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-ma1sd.md:11
@@ -332,3 +333,10 @@ msgid ""
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's "
+#~ "[documentation](https://github.com/ma1uta/ma1sd) to learn"
+#~ " what it does and why it might"
+#~ " be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po
index 9e50af971..43934ff04 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-matrix-corporal.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -42,101 +42,107 @@ msgstr ""
 msgid ""
 "In short, it's a sort of automation and firewalling service, which is "
 "helpful if you're instaling Matrix services in a controlled corporate "
-"environment. See that project's documentation to learn what it does and "
-"why it might be useful to you."
+"environment."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-matrix-corporal.md:13
 msgid ""
+"See the project's [documentation](https://github.com/devture/matrix-"
+"corporal/blob/main/README.md) to learn what it does and why it might be "
+"useful to you."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-matrix-corporal.md:15
+msgid ""
 "If you decide that you'd like to let this playbook install it for you, "
 "you'd need to also:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:14
+#: ../../../docs/configuring-playbook-matrix-corporal.md:16
 msgid ""
 "(required) [set up the Shared Secret Auth password provider module"
 "](configuring-playbook-shared-secret-auth.md)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:15
+#: ../../../docs/configuring-playbook-matrix-corporal.md:17
 msgid ""
 "(optional, but encouraged) [set up the REST authentication password "
 "provider module](configuring-playbook-rest-auth.md)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:17
+#: ../../../docs/configuring-playbook-matrix-corporal.md:19
 msgid "Adjusting the playbook configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:19
+#: ../../../docs/configuring-playbook-matrix-corporal.md:21
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:72
+#: ../../../docs/configuring-playbook-matrix-corporal.md:74
 msgid ""
 "Matrix Corporal operates with a specific Matrix user on your server. By "
 "default, it's `matrix-corporal` (controllable by the "
 "`matrix_corporal_reconciliation_user_id_local_part` setting, see above)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:74
+#: ../../../docs/configuring-playbook-matrix-corporal.md:76
 msgid ""
 "No matter what Matrix user ID you configure to run it with, make sure "
 "that:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:76
+#: ../../../docs/configuring-playbook-matrix-corporal.md:78
 msgid ""
 "the Matrix Corporal user is created by [registering it](registering-"
 "users.md) **with administrator privileges**. Use a password you remember,"
 " as you'll need to log in from time to time to create or join rooms"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:78
+#: ../../../docs/configuring-playbook-matrix-corporal.md:80
 msgid ""
 "the Matrix Corporal user is joined and has Admin/Moderator-level access "
 "to any rooms you want it to manage"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:80
+#: ../../../docs/configuring-playbook-matrix-corporal.md:82
 msgid "Using a locally-stored static policy"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:82
+#: ../../../docs/configuring-playbook-matrix-corporal.md:84
 msgid ""
 "If you'd like to use a [static policy file](https://github.com/devture"
 "/matrix-corporal/blob/master/docs/policy-providers.md#static-file-pull-"
 "style-policy-provider), you can use a configuration like this:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:114
+#: ../../../docs/configuring-playbook-matrix-corporal.md:116
 msgid ""
 "To learn more about what the policy configuration, see the matrix-"
 "corporal documentation on [policy](https://github.com/devture/matrix-"
 "corporal/blob/master/docs/policy.md)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:116
+#: ../../../docs/configuring-playbook-matrix-corporal.md:118
 msgid "Installing"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:118
+#: ../../../docs/configuring-playbook-matrix-corporal.md:120
 msgid ""
 "After configuring the playbook, run it with [playbook tags](playbook-"
 "tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:125
+#: ../../../docs/configuring-playbook-matrix-corporal.md:127
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
 "available: `just run-tags setup-aux-files,setup-corporal,start` or `just "
 "setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:127
+#: ../../../docs/configuring-playbook-matrix-corporal.md:129
 msgid ""
 "`just run-tags setup-aux-files,setup-corporal,start` is useful for "
 "maintaining your setup quickly when its components remain unchanged. If "
@@ -145,33 +151,33 @@ msgid ""
 "`just setup-all` runs the `ensure-matrix-users-created` tag too."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:129
+#: ../../../docs/configuring-playbook-matrix-corporal.md:131
 msgid "Matrix Corporal files"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:131
+#: ../../../docs/configuring-playbook-matrix-corporal.md:133
 msgid ""
 "The following local filesystem paths are mounted in the `matrix-corporal`"
 " container and can be used in your configuration (or policy):"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:133
+#: ../../../docs/configuring-playbook-matrix-corporal.md:135
 msgid "`/matrix/corporal/config` is mounted at `/etc/matrix-corporal` (read-only)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:135
+#: ../../../docs/configuring-playbook-matrix-corporal.md:137
 msgid ""
 "`/matrix/corporal/var` is mounted at `/var/matrix-corporal` (read and "
 "write)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:137
+#: ../../../docs/configuring-playbook-matrix-corporal.md:139
 msgid ""
 "`/matrix/corporal/cache` is mounted at `/var/cache/matrix-corporal` (read"
 " and write)"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-matrix-corporal.md:139
+#: ../../../docs/configuring-playbook-matrix-corporal.md:141
 msgid ""
 "As an example: you can create your own configuration files in "
 "`/matrix/corporal/config` and they will appear in `/etc/matrix-corporal` "
@@ -182,3 +188,13 @@ msgid ""
 "and write)."
 msgstr ""
 
+#~ msgid ""
+#~ "In short, it's a sort of "
+#~ "automation and firewalling service, which "
+#~ "is helpful if you're instaling Matrix"
+#~ " services in a controlled corporate "
+#~ "environment. See that project's documentation"
+#~ " to learn what it does and why"
+#~ " it might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po
index eaca549e9..4e47061d4 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-pantalaimon.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -34,7 +34,8 @@ msgstr ""
 #: ../../../docs/configuring-playbook-pantalaimon.md:5
 msgid ""
 "See the project's [documentation](https://github.com/matrix-"
-"org/pantalaimon) to learn what it does and why it might be useful to you."
+"org/pantalaimon/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-pantalaimon.md:7
@@ -90,3 +91,10 @@ msgid ""
 "these shortcuts run the `ensure-matrix-users-created` tag too."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/pantalaimon) to learn what it"
+#~ " does and why it might be "
+#~ "useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po
index 2a1d13324..ec978d039 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-rest-auth.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -35,8 +35,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-rest-auth.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you."
+"See the project's [documentation](https://github.com/ma1uta/matrix-"
+"synapse-rest-password-provider/blob/master/README.md) to learn what it "
+"does and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-rest-auth.md:7
@@ -87,3 +88,9 @@ msgid ""
 "these shortcuts run the `ensure-matrix-users-created` tag too."
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po
index 7c14374e6..7c1c8bc8b 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-shared-secret-auth.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -35,8 +35,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-shared-secret-auth.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you."
+"See the project's [documentation](https://github.com/devture/matrix-"
+"synapse-shared-secret-auth/blob/master/README.md) to learn what it does "
+"and why it might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-shared-secret-auth.md:7
@@ -86,3 +87,9 @@ msgid ""
 "these shortcuts run the `ensure-matrix-users-created` tag too."
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po
index 258e8279d..81646fa21 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-sygnal.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -32,8 +32,9 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-sygnal.md:5
 msgid ""
-"See the project's [documentation](https://github.com/matrix-org/sygnal) "
-"to learn what it does and why it might be useful to you."
+"See the project's [documentation](https://github.com/matrix-"
+"org/sygnal/blob/master/README.md) to learn what it does and why it might "
+"be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-sygnal.md:7
@@ -199,3 +200,10 @@ msgid ""
 "/matrix-org/sygnal/blob/master/docs/applications.md) document."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/sygnal) to learn what it "
+#~ "does and why it might be useful"
+#~ " to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po
index acd1713e0..bf5494b8b 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-accept-invite.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -33,15 +33,20 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:5
 msgid ""
-"See that project's [documentation](https://github.com/matrix-org/synapse-"
-"auto-accept-invite) to learn what it does and why it might be useful to "
-"you. In short, it automatically accepts room invites. You can specify "
-"that only 1:1 room invites are auto-accepted. Defaults to false if not "
+"In short, it automatically accepts room invites. You can specify that "
+"only 1:1 room invites are auto-accepted. Defaults to false if not "
 "specified."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:7
 msgid ""
+"See the project's [documentation](https://github.com/matrix-org/synapse-"
+"auto-accept-invite/blob/main/README.md) to learn what it does and why it "
+"might be useful to you."
+msgstr ""
+
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9
+msgid ""
 "**Note**: Synapse [v1.109.0](https://github.com/element-"
 "hq/synapse/releases/tag/v1.109.0), the same feature [has been "
 "merged](https://github.com/element-hq/synapse/pull/17147) into Synapse "
@@ -51,11 +56,11 @@ msgid ""
 "party module."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:9
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11
 msgid "Configuration"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:11
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:13
 msgid ""
 "If you decide that you'd like to let this playbook install the [synapse-"
 "auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-"
@@ -63,11 +68,11 @@ msgid ""
 "`inventory/host_vars/matrix.example.com/vars.yml` file:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:19
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21
 msgid "Synapse worker deployments"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:21
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:23
 msgid ""
 "In a [workerized Synapse deployment](https://github.com/spantaleev"
 "/matrix-docker-ansible-"
@@ -77,17 +82,17 @@ msgid ""
 "is `null`). For example, add this to your configuration:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:27
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29
 msgid ""
 "There might be an [issue with federation](https://github.com/matrix-org"
 "/synapse-auto-accept-invite/issues/18)."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:29
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31
 msgid "Native alternative"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:31
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33
 msgid ""
 "Since Synapse [v1.109.0](https://github.com/element-"
 "hq/synapse/releases/tag/v1.109.0), the functionality provided by the "
@@ -96,7 +101,19 @@ msgid ""
 "/element-hq/synapse/pull/17147) part of Synapse."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:33
+#: ../../../docs/configuring-playbook-synapse-auto-accept-invite.md:35
 msgid "Here's example configuration for using the **native** Synapse feature:"
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's "
+#~ "[documentation](https://github.com/matrix-org/synapse-"
+#~ "auto-accept-invite) to learn what it"
+#~ " does and why it might be "
+#~ "useful to you. In short, it "
+#~ "automatically accepts room invites. You "
+#~ "can specify that only 1:1 room "
+#~ "invites are auto-accepted. Defaults to"
+#~ " false if not specified."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po
index a7359c3c0..cb5655ca9 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-auto-compressor.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -40,8 +40,9 @@ msgstr ""
 #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:7
 msgid ""
 "See the project's [documentation](https://github.com/matrix-org/rust-"
-"synapse-compress-state/#automated-tool-synapse_auto_compressor) to learn "
-"what it does and why it might be useful to you."
+"synapse-compress-state/blob/master/README.md#automated-tool-"
+"synapse_auto_compressor) to learn what it does and why it might be useful"
+" to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-auto-compressor.md:9
@@ -106,3 +107,11 @@ msgid ""
 "unstable."
 msgstr ""
 
+#~ msgid ""
+#~ "See the project's [documentation](https://github.com"
+#~ "/matrix-org/rust-synapse-compress-state"
+#~ "/#automated-tool-synapse_auto_compressor) to "
+#~ "learn what it does and why it "
+#~ "might be useful to you."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po
index 2e0c82766..6803bc2ba 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-synapse-simple-antispam.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -32,20 +32,35 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:5
 msgid ""
-"See that project's documentation to learn what it does and why it might "
-"be useful to you. In short, it lets you fight invite-spam by "
-"automatically blocking invitiations from a list of servers specified by "
-"you (blacklisting)."
+"It lets you fight invite-spam by automatically blocking invitiations from"
+" a list of servers specified by you (blacklisting)."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:7
-msgid "Adjusting the playbook configuration"
+msgid ""
+"See the project's [documentation](https://github.com/t2bot/synapse-"
+"simple-antispam/blob/master/README.md) to learn what it does and why it "
+"might be useful to you."
 msgstr ""
 
 #: ../../../docs/configuring-playbook-synapse-simple-antispam.md:9
+msgid "Adjusting the playbook configuration"
+msgstr ""
+
+#: ../../../docs/configuring-playbook-synapse-simple-antispam.md:11
 msgid ""
 "Add the following configuration to your "
 "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
 "needs):"
 msgstr ""
 
+#~ msgid ""
+#~ "See that project's documentation to "
+#~ "learn what it does and why it "
+#~ "might be useful to you. In short,"
+#~ " it lets you fight invite-spam "
+#~ "by automatically blocking invitiations from"
+#~ " a list of servers specified by "
+#~ "you (blacklisting)."
+#~ msgstr ""
+
diff --git a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
index ddb720e35..d33faf33d 100644
--- a/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
+++ b/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-user-verification-service.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: matrix-docker-ansible-deploy \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-16 12:05+0900\n"
+"POT-Creation-Date: 2024-12-20 09:53+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: jp\n"
@@ -237,71 +237,71 @@ msgstr ""
 
 #: ../../../docs/configuring-playbook-user-verification-service.md:90
 msgid ""
-"After these variables have been set, run the playbook with [playbook tags"
-"](playbook-tags.md) as below to restart UVS:"
+"After configuring the playbook, run it with [playbook tags](playbook-"
+"tags.md) as below:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:96
+#: ../../../docs/configuring-playbook-user-verification-service.md:97
 msgid ""
 "The shortcut commands with the [`just` program](just.md) are also "
-"available: `just run-tags setup-matrix-user-verification-service,start` "
-"or `just setup-all`"
+"available: `just install-service matrix-user-verification-service` or "
+"`just setup-all`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:98
+#: ../../../docs/configuring-playbook-user-verification-service.md:99
 msgid ""
-"`just run-tags setup-matrix-user-verification-service,start` is useful "
-"for maintaining your setup quickly when its components remain unchanged. "
-"If you adjust your `vars.yml` to remove other components, you'd need to "
-"run `just setup-all`, or these components will still remain installed. "
-"Note `just setup-all` runs the `ensure-matrix-users-created` tag too."
+"`just install-service matrix-user-verification-service` is useful for "
+"maintaining your setup quickly when its components remain unchanged. If "
+"you adjust your `vars.yml` to remove other components, you'd need to run "
+"`just setup-all`, or these components will still remain installed. Note "
+"`just setup-all` runs the `ensure-matrix-users-created` tag too."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:100
+#: ../../../docs/configuring-playbook-user-verification-service.md:101
 msgid "Logging"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:102
+#: ../../../docs/configuring-playbook-user-verification-service.md:103
 msgid "The configuration variable `UVS_LOG_LEVEL` can be set to:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:103
+#: ../../../docs/configuring-playbook-user-verification-service.md:104
 msgid "warning"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:104
+#: ../../../docs/configuring-playbook-user-verification-service.md:105
 msgid "info"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:105
+#: ../../../docs/configuring-playbook-user-verification-service.md:106
 msgid "debug"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:107
+#: ../../../docs/configuring-playbook-user-verification-service.md:108
 msgid "TLS Certificate Checking"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:109
+#: ../../../docs/configuring-playbook-user-verification-service.md:110
 msgid ""
 "If the Matrix Homeserver does not provide a valid TLS certificate, UVS "
 "will fail with the following error message:"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:111
+#: ../../../docs/configuring-playbook-user-verification-service.md:112
 msgid "message: 'No response received: [object Object]',"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:113
+#: ../../../docs/configuring-playbook-user-verification-service.md:114
 msgid "This also applies to self-signed and let's encrypt staging certificates."
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:115
+#: ../../../docs/configuring-playbook-user-verification-service.md:116
 msgid ""
 "To disable certificate validation altogether (INSECURE! Not suitable for "
 "production use!) set: `NODE_TLS_REJECT_UNAUTHORIZED=0`"
 msgstr ""
 
-#: ../../../docs/configuring-playbook-user-verification-service.md:117
+#: ../../../docs/configuring-playbook-user-verification-service.md:118
 msgid ""
 "Alternatively, it is possible to inject your own CA certificates into the"
 " container by mounting a PEM file with additional trusted CAs into the "
@@ -309,3 +309,31 @@ msgid ""
 "it."
 msgstr ""
 
+#~ msgid ""
+#~ "After these variables have been set, "
+#~ "run the playbook with [playbook tags"
+#~ "](playbook-tags.md) as below to restart "
+#~ "UVS:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The shortcut commands with the [`just`"
+#~ " program](just.md) are also available: "
+#~ "`just run-tags setup-matrix-user-"
+#~ "verification-service,start` or `just setup-"
+#~ "all`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "`just run-tags setup-matrix-user-"
+#~ "verification-service,start` is useful for "
+#~ "maintaining your setup quickly when its"
+#~ " components remain unchanged. If you "
+#~ "adjust your `vars.yml` to remove other"
+#~ " components, you'd need to run `just"
+#~ " setup-all`, or these components will"
+#~ " still remain installed. Note `just "
+#~ "setup-all` runs the `ensure-matrix-"
+#~ "users-created` tag too."
+#~ msgstr ""
+