(docs) Move user-facing docs for reinstall_on_refresh into user-facing doc string

These docs, intended for users, were in a comment where only developers would
ever see them. This commit moves them into place so they'll appear in the type
reference, and restores the original developer-facing comment for the parameter.
Merge pull request #3149 from nfagerlund/docs_package_reinstall

(docs) Move user-facing docs for reinstall_on_refresh into user-facing doc string