No worries Tom Parker. The action is not currently documented, which would explain things.
Closing the PR as the fix it is not needed.
Found some documentation regarding puppet plugin download here: https://puppet.com/docs/puppet/5.3/man/plugin.html
Jean Bond does this puppet plugin download requires some new documentation, or it's in some other location than the one I found?
It sounds like the man page should be updated with the action; Josh Cooper, where would a PR for that need to go?
Ah, my mistake, I misunderstood; I see that download IS documented on the man page. Dorin Pleava, can you tell me where else you expected to find this information?
One problem may be that it's excluded from puppet help. See https://github.com/puppetlabs/puppet/blob/1b5e6095f6282f7973f70687777fbf44cb9888f4/lib/puppet/face/help.rb#L199
Jean Bond, on a better look into the docs, it seems to be documented in the correct location. I mixed it up with pluginsync.
Josh Cooper should I remove plugin from the excluded puppet help?
Merged to 6.0.x in https://github.com/puppetlabs/puppet/commit/5b115d4bb8146463df0e88b7267e640594971fa4