[stable-4] Adjust 'report this' messages to only report if the latest version still has this problem (#1174) (#1175)

* Adjust 'report this' messages to only report if the latest version still has this problem. (#1173)

(cherry picked from commit 6b5d76bdee)

* Adjust checks.

(cherry picked from commit 24f35644e3)
(cherry picked from commit 075bc91ce8)

plugins/module_utils/compose_v2.py

@@ -325,7 +325,8 @@ def _warn_missing_dry_run_prefix(line, warn_missing_dry_run_prefix, warn_functio
         # This could be a bug, a change of docker compose's output format, ...
         # Tell the user to report it to us :-)
         warn_function(
-            'Event line is missing dry-run mode marker: {0!r}. Please report this at '
+            'Event line is missing dry-run mode marker: {0!r}. Please check with the latest community.docker version,'
+            ' and if the problem still happens there, please report this at '
             'https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&projects=&template=bug_report.md'
             .format(line)
         )
@@ -336,7 +337,8 @@ def _warn_unparsable_line(line, warn_function):
     # Tell the user to report it to us :-)
     if warn_function:
         warn_function(
-            'Cannot parse event from line: {0!r}. Please report this at '
+            'Cannot parse event from line: {0!r}. Please check with the latest community.docker version,'
+            ' and if the problem still happens there, please report this at '
             'https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&projects=&template=bug_report.md'
             .format(line)
         )
@@ -384,7 +386,8 @@ def parse_json_events(stderr, warn_function=None):
                 continue
             if warn_function:
                 warn_function(
-                    'Cannot parse event from non-JSON line: {0!r}. Please report this at '
+                    'Cannot parse event from non-JSON line: {0!r}. Please check with the latest community.docker version,'
+                    ' and if the problem still happens there, please report this at '
                     'https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&projects=&template=bug_report.md'
                     .format(line)
                 )
@@ -394,7 +397,8 @@ def parse_json_events(stderr, warn_function=None):
         except Exception as exc:
             if warn_function:
                 warn_function(
-                    'Cannot parse event from line: {0!r}: {1}. Please report this at '
+                    'Cannot parse event from line: {0!r}: {1}. Please check with the latest community.docker version,'
+                    ' and if the problem still happens there, please report this at '
                     'https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&projects=&template=bug_report.md'
                     .format(line, exc)
                 )
@@ -451,7 +455,8 @@ def parse_json_events(stderr, warn_function=None):
                 except KeyError:
                     if warn_function:
                         warn_function(
-                            'Unknown resource type {0!r} in line {1!r}. Please report this at '
+                            'Unknown resource type {0!r} in line {1!r}. Please check with the latest community.docker version,'
+                            ' and if the problem still happens there, please report this at '
                             'https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&projects=&template=bug_report.md'
                             .format(resource_type_str, line)
                         )

plugins/modules/current_container_facts.py

@@ -17,7 +17,8 @@ version_added: 1.1.0
 description:
   - Return facts about whether the module runs in a Docker or podman container.
   - This module attempts a best-effort detection. There might be special cases where
-    it does not work; if you encounter one, L(please file an issue,
+    it does not work; if you encounter one, make sure that this is still a problem with
+    the latest community.docker release, and if it is, L(please file an issue,
     https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&template=bug_report.md).
 author:
   - Felix Fontein (@felixfontein)

plugins/modules/docker_container.py

@@ -774,7 +774,8 @@ options:
       - Platform for the container in the format C(os[/arch[/variant]]).
       - "Note that since community.docker 3.5.0, the module uses both the image's metadata and the Docker
          daemon's information to normalize platform strings similarly to how Docker itself is doing this.
-         If you notice idempotency problems, L(please create an issue in the community.docker GitHub repository,
+         If you notice idempotency problems, please verify whether this is still a problem with the latest
+         release of community.docker, and if it is, L(create an issue in the community.docker GitHub repository,
          https://github.com/ansible-collections/community.docker/issues/new?assignees=&labels=&projects=&template=bug_report.md).
          For older community.docker versions, you can use the O(comparisons) option with C(platform: ignore)
          to prevent accidental recreation of the container due to this."