# Align \`"\.\.\."\` documentation for file pattern settings \(\#64452\) · gitcafe/zed

[View on GitCafe](https://git.cafe/gitcafe/zed/commit/968be64a028ee5be7c50405c87afe6c9fded3739)

Repository: [gitcafe/zed](https://git.cafe/gitcafe/zed)

Visibility: public

Requested revision: 968be64a028ee5be7c50405c87afe6c9fded3739

Requested commit: 968be64a028ee5be7c50405c87afe6c9fded3739

Commit: 968be64a028ee5be7c50405c87afe6c9fded3739

Tree: 4f66ffc9116f1dde6bb22443b414385594c3bfed

Author: Dom Porada

Committer: GitHub

## Message

```
Align `"..."` documentation for file pattern settings (#64452)

## Objective

Make the `"..."` convention easier to understand across the settings
that support it.

This is a meta follow-up to
[#64399](https://github.com/zed-industries/zed/discussions/64399),
establishing a documentation pattern that subsequent PRs can follow.

## Solution

Give each setting a succinct, self-contained explanation of `"..."`,
with matching wording and examples in its Rust doc comment and settings
reference:

- `file_scan_exclusions` • #62769
- `file_scan_inclusions` • #64440
- `read_only_files` • #64222

This keeps the explanation consistent across both surfaces and aligns
the content for future documentation generated from Rust comments.

## Testing

Built the docs locally on macOS and verified the examples, links, and
anchors. The existing settings merge tests pass.

## Self-Review Checklist:

- [x] I’ve reviewed my own diff for quality, security, and reliability
- [x] Unsafe blocks (if any) have justifying comments
- [x] The content adheres to Zed’s UI standards
([UX/UI](https://github.com/zed-industries/zed/blob/main/CONTRIBUTING.md#uiux-checklist)
and
[icon](https://github.com/zed-industries/zed/blob/main/crates/icons/README.md)
guidelines)
- [x] Tests cover the new/changed behavior
- [x] Performance impact has been considered and is acceptable

---

Release Notes:

- N/A
```

## Parents

- [a8535d86b7c4f8061c35b1802734be33201d815b](https://git.cafe/gitcafe/zed/commit/a8535d86b7c4f8061c35b1802734be33201d815b?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zed/tree/968be64a028ee5be7c50405c87afe6c9fded3739?format=markdown)