Merge remote-tracking branch 'origin/main' into migrate-to-pnpm

Author: Jester175

docs/getting-started/Typed_Linting.mdx

@@ -82,7 +82,7 @@ module.exports = {
 In more detail:
 
 - `plugin:@typescript-eslint/recommended-type-checked` is a [shared configuration](../users/Shared_Configurations.mdx). It contains recommended rules that additionally require type information.
-- `parserOptions.projectService: true` indicates to ask TypeScript's type checking service for each source file's type information (see [Parser > `projectService`](../packages/Parser.mdx#projectService)).
+- `parserOptions.projectService: true` indicates to ask TypeScript's type checking service for each source file's type information (see [Parser > `projectService`](../packages/Parser.mdx#projectservice)).
 - `parserOptions.tsconfigRootDir` tells our parser the absolute path of your project's root directory (see [Parser > `tsconfigRootDir`](../packages/Parser.mdx#tsconfigrootdir)).
 
 </TabItem>
@@ -163,5 +163,5 @@ If you're having problems with typed linting, please see our [Troubleshooting FA
 
 For details on the parser options that enable typed linting, see:
 
-- [Parser > `projectService`](../packages/Parser.mdx#projectService): our recommended option, with settings to customize TypeScript project information
-- [Parser > `project`](../packages/Parser.mdx#projectService): an older option that can be used as an alternative
+- [Parser > `projectService`](../packages/Parser.mdx#projectservice): our recommended option, with settings to customize TypeScript project information
+- [Parser > `project`](../packages/Parser.mdx#project): an older option that can be used as an alternative

docs/packages/Parser.mdx

@@ -282,7 +282,7 @@ If this setting is specified, you must only lint files that are included in the
 }
 ```
 
-For an option that allows linting files outside of your TSConfig file(s), see [`projectService`](#projectService).
+For an option that allows linting files outside of your TSConfig file(s), see [`projectService`](#projectservice).
 
 <HiddenHeading id="experimental_useprojectservice" />
 

packages/eslint-plugin/docs/rules/no-unused-vars.mdx

@@ -118,3 +118,19 @@ export interface Box {
 </Tabs>
 
 If you find yourself writing runtime values only for types, consider refactoring your code to declare types directly.
+
+### Why are variables reported as unused despite being referenced by @link in JSDoc?
+
+JSDoc references are not supported by typescript-eslint.
+You can use a rule such as [`jsdoc/no-undefined-types`](https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-undefined-types.md) to resolve variables as used in JSDoc comments.
+
+```ts
+import type { Box } from './Box';
+//            ~~~
+//            'Box' is defined but never used.
+
+/**
+ * @see {@link Box}
+ */
+export function getBox() {}
+```