Document awkward names

diff --git a/docs/dev/style.md b/docs/dev/style.md
index 20f1b6253e7fba40d3d85a57718e4b884e97629c..883a6845d91189bd5d3ece691b22e19db4b39917 100644 (file)
--- a/docs/dev/style.md
+++ b/docs/dev/style.md
@@ -403,6 +403,18 @@ Default names:
 * `n_foo` -- number of foos
 * `foo_idx` -- index of `foo`
 
+Many names in rust-analyzer conflict with keywords.
+We use mangled names instead of `r#ident` syntax:
+
+```
+struct -> strukt
+crate  -> krate
+impl   -> imp
+trait  -> trait_
+fn     -> func
+enum   -> enum_
+mod    -> module
+```
 
 ## Early Returns