From b6b81786c278f645d12fa50d751b80c0c0f32f83 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20OUDOT?= <clement@oodo.net>
Date: Wed, 14 Sep 2022 15:57:15 +0200
Subject: [PATCH] Notify in documentation that MongoDB is deprecated

---
 doc/sources/admin/mongodbconfbackend.rst    |  8 +++-
 doc/sources/admin/mongodbsessionbackend.rst |  8 +++-
 doc/sources/admin/start.rst                 | 42 ++++++++++-----------
 3 files changed, 33 insertions(+), 25 deletions(-)

diff --git a/doc/sources/admin/mongodbconfbackend.rst b/doc/sources/admin/mongodbconfbackend.rst
index f8c7062e6..c0756a57b 100644
--- a/doc/sources/admin/mongodbconfbackend.rst
+++ b/doc/sources/admin/mongodbconfbackend.rst
@@ -1,11 +1,15 @@
-MongoDB configuration backends
-==============================
+MongoDB configuration backend (deprecated)
+==========================================
 
 `MongoDB <https://www.mongodb.org/>`__ is a NoSQL database that can be
 used both for storing configuration and
 :doc:`sessions<mongodbsessionbackend>`. You need to install Perl MongoDB
 module to be able to use this backend.
 
+.. tip::
+
+   `MongoDB has officially deprecated the Perl driver <https://www.mongodb.com/blog/post/the-mongodb-perl-driver-is-being-deprecated>`__, so we advice to choose another backend
+
 For Debian, you can install mongodb module with:
 
 ::
diff --git a/doc/sources/admin/mongodbsessionbackend.rst b/doc/sources/admin/mongodbsessionbackend.rst
index a0dd794e8..281ed8765 100644
--- a/doc/sources/admin/mongodbsessionbackend.rst
+++ b/doc/sources/admin/mongodbsessionbackend.rst
@@ -1,9 +1,13 @@
-MongoDB session backend
-=======================
+MongoDB session backend (deprecated)
+====================================
 
 `Apache::Session::MongoDB <https://metacpan.org/pod/Apache::Session::MongoDB>`__
 is a faster shareable session backend.
 
+.. tip::
+
+   `MongoDB has officially deprecated the Perl driver <https://www.mongodb.com/blog/post/the-mongodb-perl-driver-is-being-deprecated>`__, so we advice to choose another backend
+
 
 .. attention::
 
diff --git a/doc/sources/admin/start.rst b/doc/sources/admin/start.rst
index e8385a66b..40835a33d 100644
--- a/doc/sources/admin/start.rst
+++ b/doc/sources/admin/start.rst
@@ -344,26 +344,26 @@ Configuration database
 LL::NG needs a storage system to store its own configuration (managed by
 the manager). Choose one in the following list:
 
-=========================================== ========= ====================================================================
-Backend                                     Shareable Comment
-=========================================== ========= ====================================================================
-:doc:`File (JSON)<fileconfbackend>`                   Not shareable between servers except
-                                                      if used in conjunction with :doc:`REST<restconfbackend>`
-                                                      or with a shared file system (NFS,...).
-                                                      Selected by default during installation.
-:doc:`YAML<yamlconfbackend>` |new|                    Same as :doc:`File<fileconfbackend>` but in YAML format
-                                                      instead of JSON
-:doc:`SQL (CDBI/RDBI)<sqlconfbackend>`      ✔         **Recommended for large-scale systems**. Prefer CDBI.
-:doc:`LDAP<ldapconfbackend>`                ✔
-:doc:`MongoDB<mongodbconfbackend>`          ✔
-:doc:`SOAP<soapconfbackend>` |deprecated|   ✔         Proxy backend to be used in conjunction with another
-                                                      configuration backend. \ **Can be used to secure another backend**
-                                                      for remote servers.
-:doc:`REST<restconfbackend>` |new|          ✔         Proxy backend to be used in conjunction with another configuration
-                                                      backend. \ **Can be used to secure another backend** for
-                                                      remote servers.
-:doc:`Local<localconfbackend>` |new|                  Use only lemonldap-ng.ini parameters.
-=========================================== ========= ====================================================================
+===================================================== ========= ====================================================================
+Backend                                               Shareable Comment
+===================================================== ========= ====================================================================
+:doc:`File (JSON)<fileconfbackend>`                             Not shareable between servers except
+                                                                if used in conjunction with :doc:`REST<restconfbackend>`
+                                                                or with a shared file system (NFS,...).
+                                                                Selected by default during installation.
+:doc:`YAML<yamlconfbackend>` |new|                              Same as :doc:`File<fileconfbackend>` but in YAML format
+                                                                instead of JSON
+:doc:`SQL (CDBI/RDBI)<sqlconfbackend>`                ✔         **Recommended for large-scale systems**. Prefer CDBI.
+:doc:`LDAP<ldapconfbackend>`                          ✔
+:doc:`MongoDB<mongodbconfbackend>` |deprecated|       ✔
+:doc:`SOAP<soapconfbackend>` |deprecated|             ✔         Proxy backend to be used in conjunction with another
+                                                                configuration backend. \ **Can be used to secure another backend**
+                                                                for remote servers.
+:doc:`REST<restconfbackend>` |new|                    ✔         Proxy backend to be used in conjunction with another configuration
+                                                                backend. \ **Can be used to secure another backend** for
+                                                                remote servers.
+:doc:`Local<localconfbackend>` |new|                            Use only lemonldap-ng.ini parameters.
+===================================================== ========= ====================================================================
 
 
 .. tip::
@@ -402,7 +402,7 @@ Backend                                                          Shareable :ref:
 :doc:`Browseable MySQL<browseablemysqlsessionbackend>`           ✔         ✔                                                ✔                                                    ✔                  Recommended for those who prefer MySQL
 :doc:`Browseable LDAP<browseableldapsessionbackend>`             ✔         ✔                                                ✔                                                    ✔
 :doc:`Redis<nosqlsessionbackend>`                                ✔         ✔                                                ✔                                                    ✔                  The fastest. Must be secured by network access control.
-:doc:`MongoDB<mongodbsessionbackend>`                            ✔         ✔                                                ✔                                                    ✔                  Must be secured by network access control.
+:doc:`MongoDB<mongodbsessionbackend>` |deprecated|               ✔         ✔                                                ✔                                                    ✔                  Must be secured by network access control.
 :doc:`SQL<sqlsessionbackend>`                                    ✔         ✔                                                ✔                                                    ✔                  Unoptimized for :doc:`session explorer<features>` and :doc:`single session<features>` features.
 :doc:`REST<restsessionbackend>` |new|                            ✔         ✔                                                ✔                                                    ✔                  Proxy backend to be used in conjunction with another session backend.
 :doc:`SOAP<soapsessionbackend>`  |deprecated|                    ✔         ✔                                                ✔                                                    ✔                  Proxy backend to be used in conjunction with another session backend.