feat(typescript-eslint): add JSDoc comments on generated configs (#9672)

* feat(typescript-eslint): add JSDoc comments on generated configs

* Also add to index.ts

Author: JoshuaKGoldberg

packages/typescript-eslint/src/configs/all.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * Enables each the rules provided as a part of typescript-eslint. Note that many rules are not applicable in all codebases, or are meant to be configured.
+ * @see {@link https://typescript-eslint.io/users/configs#all}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/base.ts

@@ -1,5 +1,10 @@
 import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 
+/**
+ * A minimal ruleset that sets only the required parser and plugin options needed to run typescript-eslint.
+ * We don't recommend using this directly; instead, extend from an earlier recommended rule.
+ * @see {@link https://typescript-eslint.io/users/configs#base}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/disable-type-checked.ts

@@ -7,6 +7,10 @@
 
 import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 
+/**
+ * A utility ruleset that will disable type-aware linting and all type-aware rules available in our project.
+ * @see {@link https://typescript-eslint.io/users/configs#disable-type-checked}
+ */
 export default (
   _plugin: FlatConfig.Plugin,
   _parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/eslint-recommended.ts

@@ -5,6 +5,7 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
  * This is a compatibility ruleset that:
  * - disables rules from eslint:recommended which are already handled by TypeScript.
  * - enables rules that make sense due to TS's typechecking / transpilation.
+ * @see {@link https://typescript-eslint.io/users/configs/#eslint-recommended}
  */
 export default (
   _plugin: FlatConfig.Plugin,

packages/typescript-eslint/src/configs/recommended-type-checked-only.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * A version of `recommended` that only contains type-checked rules and disables of any corresponding core ESLint rules.
+ * @see {@link https://typescript-eslint.io/users/configs#recommended-type-checked-only}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/recommended-type-checked.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * Contains all of `recommended` along with additional recommended rules that require type information.
+ * @see {@link https://typescript-eslint.io/users/configs#recommended-type-checked}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/recommended.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * Recommended rules for code correctness that you can drop in without additional configuration.
+ * @see {@link https://typescript-eslint.io/users/configs#recommended}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/strict-type-checked-only.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * A version of `strict` that only contains type-checked rules and disables of any corresponding core ESLint rules.
+ * @see {@link https://typescript-eslint.io/users/configs#strict-type-checked-only}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/strict-type-checked.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * Contains all of `recommended`, `recommended-type-checked`, and `strict`, along with additional strict rules that require type information.
+ * @see {@link https://typescript-eslint.io/users/configs#strict-type-checked}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,

packages/typescript-eslint/src/configs/strict.ts

@@ -10,6 +10,10 @@ import type { FlatConfig } from '@typescript-eslint/utils/ts-eslint';
 import baseConfig from './base';
 import eslintRecommendedConfig from './eslint-recommended';
 
+/**
+ * Contains all of `recommended`, as well as additional strict rules that can also catch bugs.
+ * @see {@link https://typescript-eslint.io/users/configs#strict}
+ */
 export default (
   plugin: FlatConfig.Plugin,
   parser: FlatConfig.Parser,