feat(linter): mark jsdoc rules as recommended (#27689)

Marking upstream recommended rules as recommended here.

---

<sub>Stack created with <a
href="https://github.com/github/gh-stack">GitHub Stacks CLI</a> • <a
href="https://gh.io/stacks-feedback">Give Feedback 💬</a></sub>

crates/oxc_linter/src/rules/jsdoc/check_access.rs

@@ -58,6 +58,7 @@ declare_oxc_lint!(
     CheckAccess,
     jsdoc,
     restriction,
+    recommended,
     version = "0.2.16",
     short_description = "Checks that `@access` tags use one of the allowed values.",
 );

crates/oxc_linter/src/rules/jsdoc/check_property_names.rs

@@ -59,6 +59,7 @@ declare_oxc_lint!(
     CheckPropertyNames,
     jsdoc,
     correctness,
+    recommended,
     pending,
     version = "0.2.18",
     short_description = "Ensures that property names in JSDoc are not duplicated on the same block and that nested properties have defined roots.",

crates/oxc_linter/src/rules/jsdoc/check_tag_names.rs

@@ -81,6 +81,7 @@ declare_oxc_lint!(
     CheckTagNames,
     jsdoc,
     correctness,
+    recommended,
     pending,
     config = CheckTagNamesConfig,
     version = "0.3.2",

crates/oxc_linter/src/rules/jsdoc/empty_tags.rs

@@ -63,6 +63,7 @@ declare_oxc_lint!(
     EmptyTags,
     jsdoc,
     restriction,
+    recommended,
     pending,
     config = EmptyTagsConfig,
     version = "0.2.16",

crates/oxc_linter/src/rules/jsdoc/implements_on_classes.rs

@@ -56,6 +56,7 @@ declare_oxc_lint!(
     ImplementsOnClasses,
     jsdoc,
     correctness,
+    recommended,
     version = "0.3.2",
     short_description = "Reports an issue with any non-constructor function using `@implements`.",
 );

crates/oxc_linter/src/rules/jsdoc/no_defaults.rs

@@ -49,6 +49,7 @@ declare_oxc_lint!(
     NoDefaults,
     jsdoc,
     correctness,
+    recommended,
     pending,
     config = NoDefaultsConfig,
     version = "0.3.2",

crates/oxc_linter/src/rules/jsdoc/require_param.rs

@@ -108,6 +108,7 @@ declare_oxc_lint!(
     RequireParam,
     jsdoc,
     pedantic,
+    recommended,
     pending,
     config = RequireParamConfig,
     version = "0.4.3",

crates/oxc_linter/src/rules/jsdoc/require_param_description.rs

@@ -77,6 +77,7 @@ declare_oxc_lint!(
     RequireParamDescription,
     jsdoc,
     pedantic,
+    recommended,
     pending,
     config = RequireParamDescriptionConfig,
     version = "0.4.4",

crates/oxc_linter/src/rules/jsdoc/require_param_name.rs

@@ -44,6 +44,7 @@ declare_oxc_lint!(
     RequireParamName,
     jsdoc,
     pedantic,
+    recommended,
     version = "0.4.3",
     short_description = "Requires that all `@param` tags have names.",
 );

crates/oxc_linter/src/rules/jsdoc/require_property.rs

@@ -59,6 +59,7 @@ declare_oxc_lint!(
     RequireProperty,
     jsdoc,
     correctness,
+    recommended,
     pending,
     version = "0.2.18",
     short_description = "Requires that all `@typedef` and `@namespace` tags have `@property` tags when their type is a plain object.",

crates/oxc_linter/src/rules/jsdoc/require_property_description.rs

@@ -46,6 +46,7 @@ declare_oxc_lint!(
     RequirePropertyDescription,
     jsdoc,
     correctness,
+    recommended,
     version = "0.2.18",
     short_description = "Requires that all `@property` tags have descriptions.",
 );

crates/oxc_linter/src/rules/jsdoc/require_property_name.rs

@@ -46,6 +46,7 @@ declare_oxc_lint!(
     RequirePropertyName,
     jsdoc,
     correctness,
+    recommended,
     version = "0.2.18",
     short_description = "Requires that all `@property` tags have names.",
 );

crates/oxc_linter/src/rules/jsdoc/require_property_type.rs

@@ -46,6 +46,7 @@ declare_oxc_lint!(
     RequirePropertyType,
     jsdoc,
     correctness,
+    recommended,
     version = "0.2.18",
     short_description = "Requires that each `@property` tag has a type value (within curly brackets).",
 );

crates/oxc_linter/src/rules/jsdoc/require_returns.rs

@@ -93,6 +93,7 @@ declare_oxc_lint!(
     RequireReturns,
     jsdoc,
     pedantic,
+    recommended,
     pending,
     config = RequireReturnsConfig,
     version = "0.4.0",

crates/oxc_linter/src/rules/jsdoc/require_returns_description.rs

@@ -45,6 +45,7 @@ declare_oxc_lint!(
     RequireReturnsDescription,
     jsdoc,
     pedantic,
+    recommended,
     version = "0.4.0",
     short_description = "Requires that the `@returns` tag has a description value.",
 );

crates/oxc_linter/src/rules/jsdoc/require_returns_type.rs

@@ -97,7 +97,7 @@ fn test() {
 			           * @returns {number}
 			           */
 			          function quux () {
-			
+
 			          }
 			      ",
             None,
@@ -132,7 +132,7 @@ fn test() {
 			           * @returns
 			           */
 			          function quux () {
-			
+
 			          }
 			      ",
             None,
@@ -144,7 +144,7 @@ fn test() {
 			           * @returns Foo.
 			           */
 			          function quux () {
-			
+
 			          }
 			      ",
             None,
@@ -156,7 +156,7 @@ fn test() {
 			           * @return Foo.
 			           */
 			          function quux () {
-			
+
 			          }
 			      ",
             None,

crates/oxc_linter/src/rules/jsdoc/require_throws_type.rs

@@ -46,6 +46,7 @@ declare_oxc_lint!(
     RequireThrowsType,
     jsdoc,
     pedantic,
+    recommended,
     version = "1.65.0",
     short_description = "Requires a type on the `@throws` tag.",
 );

crates/oxc_linter/src/rules/jsdoc/require_yields.rs

@@ -100,6 +100,7 @@ declare_oxc_lint!(
     RequireYields,
     jsdoc,
     correctness,
+    recommended,
     config = RequireYieldsConfig,
     version = "0.3.2",
     short_description = "Requires that yields are documented with `@yields`.",

crates/oxc_linter/src/rules/jsdoc/require_yields_type.rs

@@ -42,6 +42,7 @@ declare_oxc_lint!(
     RequireYieldsType,
     jsdoc,
     pedantic,
+    recommended,
     version = "1.65.0",
     short_description = "Requires a type on the `@yields` tag.",
 );