From 40e5ccacc5fdcde5c51c5fc36ca1c5d50e3ffca6 2020-11-17 18:01:44
From: Branko Majic <branko@majic.rs>
Date: 2020-11-17 18:01:44
Subject: [PATCH] MAR-173: Updated role reference documentation and release notes.

---

diff --git a/docs/releasenotes.rst b/docs/releasenotes.rst
index e693cb5b778ff413c8a5abfbc43359d4b2434a41..fa39ac370c7a1f3b6da2c702e5d1076d4b194c5c 100644
--- a/docs/releasenotes.rst
+++ b/docs/releasenotes.rst
@@ -8,7 +8,7 @@ NEXT RELEASE
 Upgrade to Ansible 2.9.x, dropping support for Debian 8 Jessie,
 upgrade to Python 3.x, dropping support for Python 2.7.
 
-Breaking changes:
+**Breaking changes:**
 
 * Switched to Ansible 2.9.x, removing support for older versions. All
   documentation has been updated.
@@ -118,7 +118,11 @@ Breaking changes:
     dropped. Only Prosody ``0.10.x`` is supported at the moment (due
     to missing Lua LDAP bindings in Debian 9 Stretch).
 
-Bug fixes:
+  * Support for running Prosody 0.11.x has been added. This is also
+    the new default version of Prosody that gets deployed to the
+    target system.
+
+**Bug fixes:**
 
 * ``common`` role
 
@@ -132,7 +136,7 @@ Bug fixes:
     deployed to directory dedicated to Python 2 version, which means
     the checks would be performed using Python 2 instead of Python 3.
 
-New features/improvements:
+**New features/improvements:**
 
 * Tests have been updated to work with latest Molecule/Testinfra as
   part of the Ansible upgrade process.
@@ -151,7 +155,7 @@ New features/improvements:
     limit for the SMTP server to accept via
     ``mail_message_size_limit`` role parameter.
 
-Deprecations:
+**Deprecations:**
 
 * ``backup_server`` and ``backup_client`` role
 
diff --git a/docs/rolereference.rst b/docs/rolereference.rst
index 90e6924a5c788eee687d41d241c34974a6a92749..17e662b562a68ad5cf09b4877063eecc36a6e77b 100644
--- a/docs/rolereference.rst
+++ b/docs/rolereference.rst
@@ -831,6 +831,8 @@ destination machine.
 The role implements the following:
 
 * Sets-up the Prosody apt repository.
+* Sets-up the Debian backports repository and pins the ``lua-ldap``
+  package to it (needed for Lua 5.2 support with Prosody 0.11).
 * Deploys XMPP TLS private key and certificate.
 * Installs Prosody.
 * Configures Prosody.
@@ -920,7 +922,7 @@ Parameters
   Fully qualified domain name, hostname, or IP address of the LDAP server used
   for user authentication and listing.
 
-**xmpp_prosody_package** (string, optional, ``prosody-0.10``)
+**xmpp_prosody_package** (string, optional, ``prosody-0.11``)
   Name of Prosody package from the Prosody repositories to
   install. This makes it possible to easily test the latest Prosody or
   to switch to a different nightly build. It should be noted that