django_manage: improve docs for release 9.0.0

plugins/modules/cpanm.py

@@ -81,12 +81,16 @@
 notes:
   - Please note that U(http://search.cpan.org/dist/App-cpanminus/bin/cpanm, cpanm) must be installed on the remote host.
   - "This module now comes with a choice of execution O(mode): V(compatibility) or V(new)."
-  - "O(mode=compatibility): When using V(compatibility) mode, the module will keep backward compatibility. This is the default mode.
+  - >
+    O(mode=compatibility): When using V(compatibility) mode, the module will keep backward compatibility.
+    This was the default mode before community.general 9.0.0.
     O(name) must be either a module name or a distribution file. If the perl module given by O(name) is installed (at the exact O(version)
     when specified), then nothing happens. Otherwise, it will be installed using the C(cpanm) executable. O(name) cannot be an URL, or a git URL.
-    C(cpanm) version specifiers do not work in this mode."
-  - "O(mode=new): When using V(new) mode, the module will behave differently. The O(name) parameter may refer to a module name, a distribution file,
-    a HTTP URL or a git repository URL as described in C(cpanminus) documentation. C(cpanm) version specifiers are recognized."
+    C(cpanm) version specifiers do not work in this mode.
+  - >
+    O(mode=new): When using V(new) mode, the module will behave differently. The O(name) parameter may refer to a module name, a distribution file,
+    a HTTP URL or a git repository URL as described in C(cpanminus) documentation. C(cpanm) version specifiers are recognized.
+    This is the default mode from community.general 9.0.0 onwards.
 author:
   - "Franck Cuny (@fcuny)"
   - "Alexei Znamensky (@russoz)"

plugins/modules/django_manage.py

@@ -34,9 +34,10 @@
       - V(loaddata) - Searches for and loads the contents of the named O(fixtures) into the database.
       - V(migrate) - Synchronizes the database state with models and migrations.
       - V(test) - Runs tests for all installed apps.
-      - Other commands can be entered, but will fail if they are unknown to Django.  Other commands that may
+      - Other commands can be entered, but will fail if they are unknown to Django. Other commands that may
         prompt for user input should be run with the C(--noinput) flag.
       - Support for the values V(cleanup), V(syncdb), V(validate) was removed in community.general 9.0.0.
+        See note about supported versions of Django.
     type: str
     required: true
   project_path:
@@ -131,14 +132,18 @@
     version_added: 5.8.0
 
 notes:
+  - >
+    B(ATTENTION): Support for Django releases older than 4.1 has been removed in
+    community.general version 9.0.0. While the module allows for free-form commands
+    does not verify the version of Django being used, it is B(strongly recommended)
+    to use a more recent version of Django.
+  - Please notice that Django 4.1 requires Python 3.8 or greater.
   - This module will not create a virtualenv if the O(virtualenv) parameter is specified and a virtual environment
     does not already exist at the given location. This behavior changed in community.general version 9.0.0.
   - The recommended way to create a virtual environment in Ansible is by using M(ansible.builtin.pip).
   - This module assumes English error messages for the V(createcachetable) command to detect table existence,
     unfortunately.
-  - To be able to use the V(migrate) command with django versions < 1.7, you must have C(south) installed and added
-    as an app in your settings.
-  - To be able to use the V(collectstatic) command, you must have enabled staticfiles in your settings.
+  - To be able to use the V(collectstatic) command, you must have enabled C(staticfiles) in your settings.
   - Your C(manage.py) application must be executable (C(rwxr-xr-x)), and must have a valid shebang,
     for example C(#!/usr/bin/env python), for invoking the appropriate Python interpreter.
 seealso: