Skip to content

Commit d022e0e

Browse files
committed
Auto merge of rust-lang#13496 - rust-lang:lnicola-patch-1, r=jonas-schievink
internal: Clarify feature policy CC rust-lang#13495
2 parents c6e1e17 + 05514d8 commit d022e0e

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

docs/dev/architecture.md

+2
Original file line numberDiff line numberDiff line change
@@ -479,7 +479,9 @@ It is not cheap enough to enable in prod, and this is a bug which should be fixe
479479
### Configurability
480480

481481
rust-analyzer strives to be as configurable as possible while offering reasonable defaults where no configuration exists yet.
482+
The rule of thumb is to enable most features by default unless they are buggy or degrade performance too much.
482483
There will always be features that some people find more annoying than helpful, so giving the users the ability to tweak or disable these is a big part of offering a good user experience.
484+
Enabling them by default is a matter of discoverability, as many users end up don't know about some features even though they are presented in the manual.
483485
Mind the code--architecture gap: at the moment, we are using fewer feature flags than we really should.
484486

485487
### Serialization

0 commit comments

Comments
 (0)