wip: address comments

lumirlumir · lumirlumir · commit 889f7f130919 · 2025-05-27T19:23:42.000+09:00
diff --git a/docs/src/extend/ways-to-extend.md b/docs/src/extend/ways-to-extend.md
@@ -15,7 +15,7 @@ This page explains the ways to extend ESLint, and how these extensions all fit t
 
 Plugins let you add your own ESLint custom rules and custom processors to a project. You can publish a plugin as an npm module.
 
-Plugins are useful because your project may require some ESLint configuration that isn't included in the core `eslint` package. For example, if you're using a frontend JavaScript library like React or framework like Vue, these tools have some features that require custom rules outside the scope of the ESLint core rules.
+Plugins are useful because your project may require some ESLint configuration that isn't included in the core `eslint` package. For example, if you're using a frontend JavaScript library like [React](https://react.dev/) or framework like [Vue](https://vuejs.org/), these tools have some features that require custom rules outside the scope of the ESLint core rules.
 
 Often a plugin is paired with a configuration for ESLint that applies a set of features from the plugin to a project. You can include configurations in a plugin as well.
 
@@ -35,15 +35,15 @@ ESLint shareable configs are pre-defined configurations for ESLint that you can
 
 You can either publish a shareable config independently or as part of a plugin.
 
-For example, a popular shareable config is [eslint-config-airbnb](https://www.npmjs.com/package/eslint-config-airbnb), which contains a variety of rules in addition to some [parser options](../use/configure/language-options#specifying-parser-options). This is a set of rules for ESLint that is designed to match the style guide used by the [Airbnb JavaScript style guide](https://github.com/airbnb/javascript). By using the `eslint-config-airbnb` shareable config, you can automatically enforce the Airbnb style guide in your project without having to manually configure each rule.
+For example, a popular shareable config is [`eslint-config-airbnb`](https://www.npmjs.com/package/eslint-config-airbnb), which contains a variety of rules in addition to some [parser options](../use/configure/language-options#specifying-parser-options). This is a set of rules for ESLint that is designed to match the style guide used by the [Airbnb JavaScript style guide](https://github.com/airbnb/javascript). By using the `eslint-config-airbnb` shareable config, you can automatically enforce the Airbnb style guide in your project without having to manually configure each rule.
 
-To learn more about creating a shareable config, refer to [Share Configuration](shareable-configs).
+To learn more about creating a shareable config, refer to [Share Configurations](shareable-configs).
 
 ## Custom Formatters
 
 Custom formatters take ESLint linting results and output the results in a format that you define. Custom formatters let you display linting results in a format that best fits your needs, whether that's in a specific file format, a certain display style, or a format optimized for a particular tool. You only need to create a custom formatter if the [built-in formatters](../use/formatters/) don't serve your use case.
 
-For example, the custom formatter [eslint-formatter-gitlab](https://www.npmjs.com/package/eslint-formatter-gitlab) can be used to display ESLint results in GitLab code quality reports.
+For example, the custom formatter [eslint-formatter-gitlab](https://www.npmjs.com/package/eslint-formatter-gitlab) can be used to display ESLint results in [GitLab](https://about.gitlab.com/) code quality reports.
 
 To learn more about creating a custom formatter, refer to [Custom Formatters](custom-formatters).
 
diff --git a/docs/src/integrate/nodejs-api.md b/docs/src/integrate/nodejs-api.md
@@ -15,7 +15,7 @@ While ESLint is designed to be run on the command line, it's possible to use ESL
 
 The `ESLint` class is the primary class to use in Node.js applications.
 
-This class depends on the Node.js `fs` module and the file system, so you cannot use it in browsers. If you want to lint code on browsers, use the [Linter](#linter) class instead.
+This class depends on the Node.js [`fs`](https://nodejs.org/api/fs.html) module and the file system, so you cannot use it in browsers. If you want to lint code on browsers, use the [`Linter`](#linter) class instead.
 
 Here's a simple example of using the `ESLint` class:
 
@@ -68,7 +68,7 @@ const { ESLint } = require("eslint");
 });
 ```
 
-And here is an example of using the `ESLint` class with `lintText` API:
+And here is an example of using the `ESLint` class with [`lintText`](#-eslintlinttextcode-options) API:
 
 ```js
 const { ESLint } = require("eslint");
diff --git a/templates/formatter-examples.md.ejs b/templates/formatter-examples.md.ejs
@@ -10,7 +10,7 @@ edit_link: https://github.com/eslint/eslint/edit/main/templates/formatter-exampl
 
 ESLint comes with several built-in formatters to control the appearance of the linting results, and supports third-party formatters as well.
 
-You can specify a formatter using the `--format` or `-f` flag in the CLI. For example, `--format json` uses the `json` formatter.
+You can specify a formatter using the [`--format`](../command-line-interface#-f---format) or [`-f`](../command-line-interface#-f---format) flag in the CLI. For example, `--format json` uses the `json` formatter.
 
 The built-in formatter options are:
 
@@ -20,7 +20,7 @@ The built-in formatter options are:
 
 ## Example Source
 
-Examples of each formatter were created from linting `fullOfProblems.js` using the `.eslintrc.json` configuration shown below.
+Examples of each formatter were created from linting `fullOfProblems.js` using the `eslint.config.js` configuration shown below.
 
 `fullOfProblems.js`:
 
@@ -34,19 +34,22 @@ function addOne(i) {
 };
 ```
 
-`.eslintrc.json`:
-
-```json
-{
-    "extends": "eslint:recommended",
-    "rules": {
-        "consistent-return": 2,
-        "indent"           : [1, 4],
-        "no-else-return"   : 1,
-        "semi"             : [1, "always"],
-        "space-unary-ops"  : 2
-    }
-}
+`eslint.config.js`:
+
+```js
+import { defineConfig } from "eslint/config";
+
+export default defineConfig([
+	{
+		rules: {
+			"consistent-return": 2,
+			"indent"           : [1, 4],
+			"no-else-return"   : 1,
+			"semi"             : [1, "always"],
+			"space-unary-ops"  : 2
+		}
+	}
+]);
 ```
 
 Tests the formatters with the CLI:
