Skip to content

docs: update biome configuration specs #3940

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hexadecimal233 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: update biome configuration specs #3940

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0d5aa84
docs: update biome configuration specs
hexadecimal233 Feb 11, 2026
888e910
docs: zh-CN for the last commit
hexadecimal233 Feb 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions src/content/docs/guides/configure-biome.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,15 @@ will use the configuration file `app/frontend/biome.json`;
Biome (since v2.0.0) supports nested `biome.json` files. For more information, read [Use Biome in big projects](/guides/big-projects#use-multiple-configuration-files).
:::

:::note
Copy link
Member

@ematipico ematipico Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think a note is needed. You're simply extending the resolution chapter

Copy link
Author

@hexadecimal233 hexadecimal233 Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the es lang, that note was in place and added as-is.

website/src/content/docs/es/guides/configure-biome.mdx

Line 97 in d54553b

:::note

If it isn't needed after all, all notes should be deleted then

Copy link
Member

@ematipico ematipico Feb 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe es is outdated... En is always up to date

Biome commands support the use of the `--config-path` option and the `BIOME_CONFIG_PATH` environment variable.
This allows you to specify a custom configuration file or a directory where Biome can look for a `biome.json` or `biome.jsonc` file.
When using `--config-path` or `BIOME_CONFIG_PATH`, the standard configuration file resolution process is **disabled**.

If `--config-path` or `BIOME_CONFIG_PATH` point directly to a file, you can use names other than `biome.json` or `biome.jsonc`.
Biome will read a `.json` file using a standard JSON parser.
For files with other extensions, Biome will treat them as `.jsonc` files, using a more flexible JSON parser that allows comments and trailing commas.
:::

## Specifying files to process

Expand Down
10 changes: 10 additions & 0 deletions src/content/docs/zh-CN/guides/configure-biome.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,16 @@ Biome（自 v2.0.0 起）支持嵌套的 `biome.json` 文件。
欲了解更多信息，请阅读[在大型项目中使用 Biome](/zh-cn/guides/big-projects#use-multiple-configuration-files)。
:::

:::note
Biome 命令支持使用 `--config-path` 选项和 `BIOME_CONFIG_PATH` 环境变量。
这允许您指定自定义配置文件或 Biome 可以查找 `biome.json` 或 `biome.jsonc` 文件的目录。
当使用 `--config-path` 或 `BIOME_CONFIG_PATH` 时，标准的配置文件解析过程**将被禁用**。

如果 `--config-path` 或 `BIOME_CONFIG_PATH` 直接指向一个文件，您可以使用 `biome.json` 或 `biome.jsonc` 以外的名称。
Biome 将使用标准的 JSON 解析器读取 `.json` 文件。
对于其他扩展名的文件，Biome 会将它们视为 `.jsonc` 文件，使用更灵活的 JSON 解析器，允许注释和尾随逗号。
:::


## 指定要处理的文件

Expand Down
Loading