bazelbuild / bazelbuild/bazel

user.bazelrc or .bazelrc.user?

Open
#28,839 3 comments 0 reactions 0 assignees View on GitHub
help wanted P2 team-Documentation team-OSS type: documentation (cleanup)
Dominant language
Java
Stars
25.8k
Forks
4.6k
Avg merge
2d 20h
Merged PRs (30d)
72

Description

### Page link:

_No response_

### Problem description (include actual vs expected text, if applicable):

[Bazel best practices](https://bazel.build/configure/best-practices#bazelrc-file) recommends

```
try-import %workspace%/user.bazelrc
```

But [rules-template](https://github.com/bazel-contrib/rules-template/blob/012c564199f9cef3273ca99da2e0e407a10245ca/.bazelrc#L39C1-L39C37) has

```
try-import %workspace%/.bazelrc.user
```

Which is it? It would be nice to be consistent, for users to be able to override project flags in a predictable location.

### Where do you see this issue? (include link to specific section of the page, if applicable)

_No response_

### Any other information you'd like to share?

_No response_

Contributor guide

Open the contributing guide

Research direction

Read the linked Bazel best-practices section and the rules-template .bazelrc example first, then locate the repository documentation source for the guidance being discussed. Confirm the canonical per-user filename and update the relevant documentation or reference so the examples agree; done means the convention is stated consistently.

Written by the indexing model from the issue text.

Assessment

Domain
build-system, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.