diff --git a/editors/code/README.md b/editors/code/README.md
index 46c6f6f2aa5..a5593e11109 100644
--- a/editors/code/README.md
+++ b/editors/code/README.md
@@ -1,34 +1,31 @@
 # rust-analyzer
 
-Provides support for rust-analyzer: novel LSP server for the Rust programming language.
-
-**Note** the extension may cause conflicts with the official Rust extension. It is recommended to disable the Rust extension when using the rust-analyzer extension.
+This extension proves support for the [Rust programming language](https://www.rust-lang.org/).
 
 ## Features
 
-- [code completion], [imports insertion]
-- [go to definition], [implementation], [type definition]
-- [find all references], [workspace symbol search], [rename]
+- [code completion] with [imports insertion]
+- go to [definition], [implementation], [type definition]
+- [find all references], [workspace symbol search], [symbol renaming]
 - [types and documentation on hover]
-- [inlay hints]
+- [inlay hints] for types and parameter names
 - [semantic syntax highlighting]
-- a lot of [assist(code actions)]
+- a lot of [assists(code actions)]
 - apply suggestions from errors
 - ... and many more, checkout the [manual] to see them all
 
 [code completion]: https://rust-analyzer.github.io/manual.html#magic-completions
-[imports insertion]: https://rust-analyzer.github.io/manual.html#auto-import
-[go to definition]: https://rust-analyzer.github.io/manual.html#go-to-definition
+[imports insertion]: https://rust-analyzer.github.io/manual.html#completion-with-autoimport
+[definition]: https://rust-analyzer.github.io/manual.html#go-to-definition
 [implementation]: https://rust-analyzer.github.io/manual.html#go-to-implementation
 [type definition]: https://rust-analyzer.github.io/manual.html#go-to-type-definition
 [find all references]: https://rust-analyzer.github.io/manual.html#find-all-references
 [workspace symbol search]: https://rust-analyzer.github.io/manual.html#workspace-symbol
-[rename]: https://rust-analyzer.github.io/manual.html#rename
+[symbol renaming]: https://rust-analyzer.github.io/manual.html#rename
 [types and documentation on hover]: https://rust-analyzer.github.io/manual.html#hover
 [inlay hints]: https://rust-analyzer.github.io/manual.html#inlay-hints
 [semantic syntax highlighting]: https://rust-analyzer.github.io/manual.html#semantic-syntax-highlighting
-[assist(code actions)]: https://rust-analyzer.github.io/manual.html#assists-code-actions
-
+[assists(code actions)]: https://rust-analyzer.github.io/manual.html#assists-code-actions
 [manual]: https://rust-analyzer.github.io/manual.html
 
 ## Quick start