diff --git a/plugins/modules/apk.py b/plugins/modules/apk.py
index 4259697e26..a6b058b932 100644
--- a/plugins/modules/apk.py
+++ b/plugins/modules/apk.py
@@ -35,7 +35,9 @@ options:
     default: false
   name:
     description:
-      - A package name, like V(foo), or multiple packages, like V(foo, bar).
+      - A package name, like V(foo), or multiple packages, like V(foo,bar).
+      - Do not include additional whitespace when specifying multiple packages as a string.
+        Prefer YAML lists over comma-separating multiple package names.
     type: list
     elements: str
   no_cache: