diff --git a/messages/password.generate.json b/messages/password.generate.json
index 262cf8c2..d265843a 100644
--- a/messages/password.generate.json
+++ b/messages/password.generate.json
@@ -1,5 +1,5 @@
 {
-  "description": "generate a password for scratch org users",
+  "description": "generate a password for scratch org users\nGenerates and sets a random password for one or more scratch org users. Targets the usernames listed with the --onbehalfof parameter or the --targetusername parameter. Defaults to the defaultusername.\n\nIf you haven’t set a default Dev Hub, or if your scratch org isn’t associated with your default Dev Hub, --targetdevhubusername is required.\n\nTo see a password that was previously generated, run \"sfdx force:user:display\".",
   "examples": [
     "sfdx force:user:password:generate",
     "sfdx force:user:password:generate -u me@my.org --json",