docs: call out "recommended" rules in README with instructions on how to extend

Author: brettz9

.README/README.md

@@ -72,39 +72,50 @@ Add `plugins` section and specify `eslint-plugin-jsdoc` as a plugin.
 
 Finally, enable all of the rules that you would like to use.
 
-```json
+```javascript
 {
     "rules": {
-        "jsdoc/check-alignment": 1,
+        "jsdoc/check-alignment": 1, // Recommended
         "jsdoc/check-examples": 1,
         "jsdoc/check-indentation": 1,
-        "jsdoc/check-param-names": 1,
+        "jsdoc/check-param-names": 1, // Recommended
         "jsdoc/check-syntax": 1,
-        "jsdoc/check-tag-names": 1,
-        "jsdoc/check-types": 1,
-        "jsdoc/implements-on-classes": 1,
+        "jsdoc/check-tag-names": 1, // Recommended
+        "jsdoc/check-types": 1, // Recommended
+        "jsdoc/implements-on-classes": 1, // Recommended
         "jsdoc/match-description": 1,
-        "jsdoc/newline-after-description": 1,
+        "jsdoc/newline-after-description": 1, // Recommended
         "jsdoc/no-types": 1,
-        "jsdoc/no-undefined-types": 1,
+        "jsdoc/no-undefined-types": 1, // Recommended
         "jsdoc/require-description": 1,
         "jsdoc/require-description-complete-sentence": 1,
         "jsdoc/require-example": 1,
         "jsdoc/require-hyphen-before-param-description": 1,
-        "jsdoc/require-jsdoc": 1,
-        "jsdoc/require-param": 1,
-        "jsdoc/require-param-description": 1,
-        "jsdoc/require-param-name": 1,
-        "jsdoc/require-param-type": 1,
-        "jsdoc/require-returns": 1,
-        "jsdoc/require-returns-check": 1,
-        "jsdoc/require-returns-description": 1,
-        "jsdoc/require-returns-type": 1,
-        "jsdoc/valid-types": 1
+        "jsdoc/require-jsdoc": 1, // Recommended
+        "jsdoc/require-param": 1, // Recommended
+        "jsdoc/require-param-description": 1, // Recommended
+        "jsdoc/require-param-name": 1, // Recommended
+        "jsdoc/require-param-type": 1, // Recommended
+        "jsdoc/require-returns": 1, // Recommended
+        "jsdoc/require-returns-check": 1, // Recommended
+        "jsdoc/require-returns-description": 1, // Recommended
+        "jsdoc/require-returns-type": 1, // Recommended
+        "jsdoc/valid-types": 1 // Recommended
     }
 }
 ```
 
+You may also use the following which enables the rules commented
+above as "recommended":
+
+```json
+{
+  "extends": ["plugin:jsdoc/recommended"]
+}
+```
+
+You can then selectively add to or override the recommended rules.
+
 ## Settings
 
 ### Allow `@private` to disable rules for that comment block

README.md

@@ -118,39 +118,50 @@ Add `plugins` section and specify `eslint-plugin-jsdoc` as a plugin.
 
 Finally, enable all of the rules that you would like to use.
 
-```json
+```javascript
 {
     "rules": {
-        "jsdoc/check-alignment": 1,
+        "jsdoc/check-alignment": 1, // Recommended
         "jsdoc/check-examples": 1,
         "jsdoc/check-indentation": 1,
-        "jsdoc/check-param-names": 1,
+        "jsdoc/check-param-names": 1, // Recommended
         "jsdoc/check-syntax": 1,
-        "jsdoc/check-tag-names": 1,
-        "jsdoc/check-types": 1,
-        "jsdoc/implements-on-classes": 1,
+        "jsdoc/check-tag-names": 1, // Recommended
+        "jsdoc/check-types": 1, // Recommended
+        "jsdoc/implements-on-classes": 1, // Recommended
         "jsdoc/match-description": 1,
-        "jsdoc/newline-after-description": 1,
+        "jsdoc/newline-after-description": 1, // Recommended
         "jsdoc/no-types": 1,
-        "jsdoc/no-undefined-types": 1,
+        "jsdoc/no-undefined-types": 1, // Recommended
         "jsdoc/require-description": 1,
         "jsdoc/require-description-complete-sentence": 1,
         "jsdoc/require-example": 1,
         "jsdoc/require-hyphen-before-param-description": 1,
-        "jsdoc/require-jsdoc": 1,
-        "jsdoc/require-param": 1,
-        "jsdoc/require-param-description": 1,
-        "jsdoc/require-param-name": 1,
-        "jsdoc/require-param-type": 1,
-        "jsdoc/require-returns": 1,
-        "jsdoc/require-returns-check": 1,
-        "jsdoc/require-returns-description": 1,
-        "jsdoc/require-returns-type": 1,
-        "jsdoc/valid-types": 1
+        "jsdoc/require-jsdoc": 1, // Recommended
+        "jsdoc/require-param": 1, // Recommended
+        "jsdoc/require-param-description": 1, // Recommended
+        "jsdoc/require-param-name": 1, // Recommended
+        "jsdoc/require-param-type": 1, // Recommended
+        "jsdoc/require-returns": 1, // Recommended
+        "jsdoc/require-returns-check": 1, // Recommended
+        "jsdoc/require-returns-description": 1, // Recommended
+        "jsdoc/require-returns-type": 1, // Recommended
+        "jsdoc/valid-types": 1 // Recommended
     }
 }
 ```
 
+You may also use the following which enables the rules commented
+above as "recommended":
+
+```json
+{
+  "extends": ["plugin:jsdoc/recommended"]
+}
+```
+
+You can then selectively add to or override the recommended rules.
+
 <a name="eslint-plugin-jsdoc-settings"></a>
 ## Settings