refactor: introduce the configure-biome guide

astro.config.ts

@@ -78,6 +78,15 @@ export default defineConfig({
 								"pt-BR": "Instalação manual",
 							},
 						},
+						{
+							label: "Configure Biome",
+							link: "/guides/configure-biome",
+							translations: {
+								ja: "バイオームの設定",
+								"zh-CN": "配置生物群落",
+								"pt-BR": "Configurar Bioma",
+							},
+						},
 						{
 							label: "Use Biome in big projects",
 							link: "/guides/big-projects",
@@ -87,15 +96,6 @@ export default defineConfig({
 								"pt-BR": "Usando o Biome em projetos grandes",
 							},
 						},
-						{
-							label: "How Biome works",
-							link: "/guides/how-biome-works",
-							translations: {
-								ja: "Biome の振る舞い",
-								"zh-CN": "Biome 工作原理",
-								"pt-BR": "Como o Biome funciona",
-							},
-						},
 						{
 							label: "Biome in your IDE",
 							translations: {

src/content/blog/biome-v1-7.md

@@ -279,7 +279,7 @@ The following rules are promoted:
 
 - You can now ignore `React` imports in the rules [noUnusedImports](/linter/rules/no-unused-imports/#options) and [useImportType](/linter/rules/use-import-type/#options) by setting [`javascript.jsxRuntime`](/reference/configuration/#javascriptjsxruntime) to `reactClassic`.
 
-- Biome applies specific settings to [well-known files](/guides/how-biome-works/#well-known-files).
+- Biome applies specific settings to [well-known files](/guides/configure-biome/#well-known-files).
   It now recognizes more files and distinguishes between JSON files that only allow comments and JSON files that allow both comments and trailing commas.
 
 - In the React ecosystem, files ending in `.js` are allowed to contain JSX syntax.

src/content/docs/formatter/index.mdx

@@ -44,10 +44,10 @@ For more information about all the available options, check the [CLI reference](
 Biome provides some options to tune the behavior of its formatter.
 Differently from other tools, Biome separates language-agnostic options from language-specific options.
 
-The formatter options can be set on the [CLI](/reference/cli/#biome-format) or via a [Biome configuration file](/guides/how-biome-works/#configuration).
+The formatter options can be set on the [CLI](/reference/cli/#biome-format) or via a [Biome configuration file](/guides/configure-biome).
 Biome doesn't support `.editorconfig` [yet](https://github.com/biomejs/biome/issues/1724).
 
-It's recommended to use a [Biome configuration file](/guides/how-biome-works#configuration) to ensure that both the Biome CLI and the Biome LSP apply the same options.
+It's recommended to use a [Biome configuration file](/guides/configure-biome) to ensure that both the Biome CLI and the Biome LSP apply the same options.
 The following defaults are applied:
 
 ```json title="biome.json"
@@ -90,7 +90,7 @@ The main language-agnostic options supported by the Biome formatter are:
 See the [configuration reference](/reference/configuration#formatter) for more details.
 
 
-## Ignoring Code
+## Ignore Code
 
 There are times when the formatted code isn't ideal.
 
@@ -125,29 +125,5 @@ const expr =
   ];
 ```
 
-
-## Ignoring files
-
 Biome doesn't provide ignore comments that ignore an entire file.
-However, you can ignore a file using the Biome configuration file.
-
-You can ignore files for all tools, including the formatter,
-using the [`files.ignore` configuration](/guides/how-biome-works#include-and-ignore-explained).
-By default, Biome ignores the [protected files](/guides/how-biome-works#protected-files).
-
-If you want to exclude files from being formatted, you can use `formatter.ignore`:
-
-```json title="biome.jsonc"
-{
-  "files": {
-    // All tools, including the formatter, ignore following files
-    "ignore": ["dist/**"]
-  },
-  "formatter": {
-    // Only the formatter ignores the following files
-    "ignore": ["test/**"]
-  }
-}
-```
-
-Note that you can also [ignore files ignored by your VCS](/guides/integrate-in-vcs#use-the-ignore-file).
+However, you can [ignore a file using the Biome configuration file](/guides/configure-biome/#ignore-files).

src/content/docs/guides/big-projects.mdx

@@ -38,7 +38,7 @@ When you run a script from `app/frontend/legacy-app/package.json` or `app/fronte
 
 ## Share the configuration
 
-It's possible to use the [`extends`](/guides/how-biome-works/#the-extends-option) configuration option to breakdown options across files.
+It's possible to use the [`extends`](/guides/configure-biome/#share-a-configuration-file) configuration option to breakdown options across files.
 
 Let's assume that we have these requirements:
 - `legacy-app` have to format using spaces;