Merge pull request #4003 from luixxiul/fix

Update files for ma1sd

docs/configuring-playbook-ma1sd.md

@@ -47,15 +47,15 @@ To enable matrix.org forwarding, add the following configuration to your `vars.y
 matrix_ma1sd_matrixorg_forwarding_enabled: true
 ```
 
-### Additional features
+### Extending the configuration
 
-What this playbook configures for your is some bare minimum Identity Server functionality, so that you won't need to rely on external 3rd party services.
+There are some additional things you may wish to configure about the component.
 
-A few variables can be toggled in this playbook to alter the ma1sd configuration that gets generated.
+Take a look at:
 
-Still, ma1sd can do much more. You can refer to the [ma1sd website](https://github.com/ma1uta/ma1sd) for more details and configuration options.
+- `roles/custom/matrix-ma1sd/defaults/main.yml` for some variables that you can customize via your `vars.yml` file. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_ma1sd_configuration_extension_yaml` variable
 
-To use a more custom configuration, you can define a `matrix_ma1sd_configuration_extension_yaml` string variable and put your configuration in it. To learn more about how to do this, refer to the information about `matrix_ma1sd_configuration_extension_yaml` in the [default variables file](../roles/custom/matrix-ma1sd/defaults/main.yml) of the ma1sd component.
+You can refer to the [ma1sd website](https://github.com/ma1uta/ma1sd) for more details and configuration options.
 
 #### Customizing email templates
 
@@ -150,10 +150,13 @@ The shortcut commands with the [`just` program](just.md) are also available: `ju
 
 If email address validation emails sent by ma1sd are not reaching you, you should look into [Adjusting email-sending settings](configuring-playbook-email.md).
 
-If you'd like additional logging information, temporarily enable verbose logging for ma1sd.
+As with all other services, you can find the logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by logging in to the server with SSH and running `journalctl -fu matrix-ma1sd`.
 
-To enable it, add the following configuration to your `vars.yml` file:
+### Increase logging verbosity
+
+If you want to increase the verbosity, add the following configuration to your `vars.yml` file and re-run the playbook:
 
 ```yaml
-matrix_ma1sd_verbose_logging: true
+# See: https://github.com/ma1uta/ma1sd/blob/master/docs/troubleshooting.md#increase-verbosity
+matrix_ma1sd_verbose_logging: false
 ```

roles/custom/matrix-ma1sd/defaults/main.yml

@@ -189,7 +189,7 @@ matrix_ma1sd_self_check_validate_certificates: true
 
 # Controls ma1sd logging verbosity for troubleshooting.
 #
-# According to: https://github.com/ma1uta/ma1sd/blob/master/docs/troubleshooting.md#increase-verbosity
+# See: https://github.com/ma1uta/ma1sd/blob/master/docs/troubleshooting.md#increase-verbosity
 matrix_ma1sd_verbose_logging: false
 
 # Setting up support for API prefixes