feat: hidden files and known folders

[ematipico]

Summary

Part of biomejs/biome#8663

• Document the new hidden files
• Document the new config folder
• Document the supported known files of the editors

[netlify]

✅ Deploy Preview for biomejs ready!

Name	Link
🔨 Latest commit	fac3c50
🔍 Latest deploy log	https://app.netlify.com/projects/biomejs/deploys/69592205bb947e00086d5470
😎 Deploy Preview	https://deploy-preview-3776--biomejs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Walkthrough

The changes update the Biome configuration documentation to clarify the configuration file resolution process, including all supported file formats (biome.json, biome.jsonc, .biome.json, .biome.jsonc) and the discovery order across the current working directory, parent folders, and home directory. The nested configuration note has been generalised to remove version-specific references. Additionally, the file inclusion guidance now covers project-specific settings folders for VS Code, Zed, and Cursor, along with their respective user-level configuration directories.

Pre-merge checks

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately reflects the main changes: documenting hidden configuration files (biome.json, .biome.json variants) and known editor folders (.vscode, .zed, .cursor).
Description check	✅ Passed	The description directly relates to the changeset, covering documentation of new hidden files, config folder discovery, and supported editor configuration folders.

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c428052 and fac3c50.

📒 Files selected for processing (1)

• src/content/docs/guides/configure-biome.mdx

🧰 Additional context used

🧠 Learnings (1)

📚 Learning: 2025-11-28T01:34:31.084Z

Learnt from: CR
Repo: biomejs/website PR: 0
File: CONTRIBUTING.md:0-0
Timestamp: 2025-11-28T01:34:31.084Z
Learning: Set the BIOME_VERSION environment variable when running codegen commands (e.g., BIOME_VERSION=2.0.0 pnpm codegen all)

Applied to files:

• src/content/docs/guides/configure-biome.mdx

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)

• GitHub Check: Redirect rules - biomejs
• GitHub Check: Header rules - biomejs
• GitHub Check: Pages changed - biomejs
• GitHub Check: test

🔇 Additional comments (3)

src/content/docs/guides/configure-biome.mdx (3)

81-97: Excellent clarification of configuration discovery.

The expanded documentation clearly articulates the supported file formats and discovery hierarchy across directories with appropriate OS-specific paths. The fallback to default configuration is well-documented.

---

119-121: Good generalisation of version-specific language.

Removing the v2.0.0 reference makes the documentation more maintainable and less prone to becoming outdated. The reference to the big-projects guide is appropriate.

---

308-310: Add documentation link for Cursor to match VS Code and Zed.

Cursor has official configuration documentation available. For consistency with the VS Code and Zed entries above, add a link to Cursor's settings documentation alongside the .cursor/* folder reference.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[arendjr]

👍