- Refactoring: Switch publicOnly to option (and add docs and schema therefor)

Author: brettz9

.README/README.md

@@ -118,19 +118,6 @@ Finally, enable all of the rules that you would like to use.
   above functions/methods with no parameters or return values (intended where
   variable names are sufficient for themselves as documentation).
 
-### Requiring JSDoc comments for exported functions in <code>require-jsdoc</code>
-
-- `settings.jsdoc.publicOnly` - Missing jsdoc blocks
-  are only reported for function bodies / class declarations that are exported from the module.
-  May be a boolean or object.
-
-  This setting object supports the following keys:
-
-  - `ancestorsOnly` - Only check node ancestors to check if node is exported
-  - `exports` - ESM exports are checked for JSDoc comments
-  - `modules` - CommonJS exports are checked for JSDoc comments
-  - `browserEnv` - Populates window variable
-
 ### Alias Preference
 
 Use `settings.jsdoc.tagNamePreference` to configure a preferred alias name for a JSDoc tag. The format of the configuration is: `<primary tag name>: <preferred alias name>`, e.g.

.README/rules/require-jsdoc.md

@@ -3,10 +3,32 @@
 Checks for presence of jsdoc comments, on class declarations as well as
 functions.
 
+#### Options
+
+Accepts one optional options object, with two optional keys, `publicOnly`
+for confining JSDoc comments to be checked to exported functions (with "exported"
+allowing for ESM exports, CJS exports, or browser window global export)
+in `require-jsdoc`, and `require` for limiting the contexts which are to
+be checked by the rule.
+
+- `publicOnly` - Missing jsdoc blocks are only reported for function
+  bodies / class declarations that are exported from the module.
+  May be a boolean or object. If set to `true`, the defaults below will
+  be used.
+
+  This object supports the following optional boolean keys (`false` unless
+  otherwise noted):
+
+  - `ancestorsOnly` - Only check node ancestors to check if node is exported
+  - `exports` - ESM exports are checked for JSDoc comments (Defaults to `true`)
+  - `modules` - CommonJS exports are checked for JSDoc comments  (Defaults to `true`)
+  - `browserEnv` - Populates window variable
+
 |||
 |---|---|
 |Context|`ArrowFunctionExpression`, `ClassDeclaration`, `FunctionDeclaration`, `FunctionExpression`|
 |Tags|N/A|
-|Settings|`exemptEmptyFunctions`, `publicFunctionsOnly`|
+|Options|`publicOnly`|
+|Settings|`exemptEmptyFunctions`|
 
 <!-- assertions requireJsdoc -->