user.bazelrc or .bazelrc.user?
- 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
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