improved resetTokenReuseIfValid docs

Author: mtrezza

resources/buildConfigDefinitions.js

@@ -19,7 +19,7 @@ const nestedOptionTypes = [
   'FileUploadOptions',
   'CustomPagesOptions',
   'PagesCustomUrlsOptions',
-  'PagesOptions'
+  'PagesOptions',
 ];
 
 // The prefix of environment variables for nested options.

src/Options/Definitions.js

@@ -701,8 +701,10 @@ module.exports.PasswordPolicyOptions = {
   },
   resetTokenReuseIfValid: {
     env: 'PARSE_SERVER_PASSWORD_POLICY_RESET_TOKEN_REUSE_IF_VALID',
-    help: "resend token if it's still valid",
+    help:
+      'Reuse password reset token if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.',
     action: parsers.booleanParser,
+    default: false,
   },
   resetTokenValidityDuration: {
     env: 'PARSE_SERVER_PASSWORD_POLICY_RESET_TOKEN_VALIDITY_DURATION',

src/Options/docs.js

@@ -162,7 +162,7 @@
  * @property {Boolean} doNotAllowUsername disallow username in passwords
  * @property {Number} maxPasswordAge days for password expiry
  * @property {Number} maxPasswordHistory setting to prevent reuse of previous n passwords
- * @property {Boolean} resetTokenReuseIfValid resend token if it's still valid
+ * @property {Boolean} resetTokenReuseIfValid Reuse password reset token if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.
  * @property {Number} resetTokenValidityDuration time for token to expire
  * @property {Function} validatorCallback a callback function to be invoked to validate the password
  * @property {String} validatorPattern a RegExp object or a regex string representing the pattern to enforce

src/Options/index.js

@@ -374,7 +374,8 @@ export interface PasswordPolicyOptions {
   maxPasswordHistory: ?number;
   /* time for token to expire */
   resetTokenValidityDuration: ?number;
-  /* resend token if it's still valid */
+  /* Reuse password reset token if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.
+  :DEFAULT: false */
   resetTokenReuseIfValid: ?boolean;
 }