improved resetTokenValidityDuration docs

Author: mtrezza

src/Options/Definitions.js

@@ -702,13 +702,14 @@ module.exports.PasswordPolicyOptions = {
   resetTokenReuseIfValid: {
     env: 'PARSE_SERVER_PASSWORD_POLICY_RESET_TOKEN_REUSE_IF_VALID',
     help:
-      'Reuse password reset token if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.',
+      'Is true if the password reset token should be reused 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',
-    help: 'time for token to expire',
+    help:
+      'The time duration in seconds after which a password reset token expires and becomes invalid. Default is indefinite (never expires).',
     action: parsers.numberParser('resetTokenValidityDuration'),
   },
   validatorCallback: {

src/Options/docs.js

@@ -162,8 +162,8 @@
  * @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 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 {Boolean} resetTokenReuseIfValid Is true if the password reset token should be reused if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.
+ * @property {Number} resetTokenValidityDuration The time duration in seconds after which a password reset token expires and becomes invalid. Default is indefinite (never expires).
  * @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

@@ -372,9 +372,9 @@ export interface PasswordPolicyOptions {
   maxPasswordAge: ?number;
   /* setting to prevent reuse of previous n passwords */
   maxPasswordHistory: ?number;
-  /* time for token to expire */
+  /* The time duration in seconds after which a password reset token expires and becomes invalid. Default is indefinite (never expires). */
   resetTokenValidityDuration: ?number;
-  /* Reuse password reset token if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.
+  /* Is true if the password reset token should be reused if it has not expired; requires `resetTokenValidityDuration` to be set. Default is `false`.
   :DEFAULT: false */
   resetTokenReuseIfValid: ?boolean;
 }