diff --git a/library/packaging/yum b/library/packaging/yum
index b0f0b5ea5a..d34b20b066 100644
--- a/library/packaging/yum
+++ b/library/packaging/yum
@@ -34,18 +34,18 @@ description:
 options:
   name:
     description:
-      - "package name, or package specifier with version, like C(name-1.0) in state=latest this can be '*' which means run: yum -y update. also you can pass a url or a local path to a rpm file."
+      - "Package name, or package specifier with version, like C(name-1.0). When using state=latest, this can be '*' which means run: yum -y update. You can also pass a url or a local path to a rpm file."
     required: true
     default: null
     aliases: []
   list:
     description:
-      - various non-idempotent commands for usage with C(/usr/bin/ansible) and I(not) playbooks. See examples.
+      - Various non-idempotent commands for usage with C(/usr/bin/ansible) and I(not) playbooks. See examples.
     required: false
     default: null
   state:
     description:
-      - whether to install (C(present), C(latest)), or remove (C(absent)) a package.
+      - Whether to install (C(present), C(latest)), or remove (C(absent)) a package.
     required: false
     choices: [ "present", "latest", "absent" ]
     default: "present"