about summary refs log tree commit diff
path: root/docs/dev
diff options
context:
space:
mode:
authorbors <bors@rust-lang.org>2022-10-27 13:37:45 +0000
committerbors <bors@rust-lang.org>2022-10-27 13:37:45 +0000
commitd022e0ec536948ced38ac67dec0d64c312264f7c (patch)
treecabeeb1d6916b51a6aeed4b5fa6b3a6a14175961 /docs/dev
parentc6e1e17a10f9a0c55dad34419403d1327680f240 (diff)
parent05514d8233af81206077f3d1af5afda2691b1c33 (diff)
downloadrust-d022e0ec536948ced38ac67dec0d64c312264f7c.tar.gz
rust-d022e0ec536948ced38ac67dec0d64c312264f7c.zip
Auto merge of #13496 - rust-lang:lnicola-patch-1, r=jonas-schievink
internal: Clarify feature policy

CC #13495
Diffstat (limited to 'docs/dev')
-rw-r--r--docs/dev/architecture.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/dev/architecture.md b/docs/dev/architecture.md
index c173a239fea..e3a4fdfda90 100644
--- a/docs/dev/architecture.md
+++ b/docs/dev/architecture.md
@@ -479,7 +479,9 @@ It is not cheap enough to enable in prod, and this is a bug which should be fixe
 ### Configurability
 
 rust-analyzer strives to be as configurable as possible while offering reasonable defaults where no configuration exists yet.
+The rule of thumb is to enable most features by default unless they are buggy or degrade performance too much.
 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.
+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.
 Mind the code--architecture gap: at the moment, we are using fewer feature flags than we really should.
 
 ### Serialization