1 files changed, 38 insertions, 1 deletions

diff --git a/editors/code/README.md b/editors/code/README.md
index e7d7a06f0..67df34f7e 100644
--- a/editors/code/README.md
+++ b/editors/code/README.md
@@ -2,8 +2,22 @@
 
 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.
 
-Features:
+**Note** the project is in alpha status: it is already useful in practice, but can't be considered stable.
+
+## Sponsor
+
+Work on rust-analyzer is sponsored by
+
+[<img src="https://user-images.githubusercontent.com/1711539/58105231-cf306900-7bee-11e9-83d8-9f1102e59d29.png" alt="Ferrous Systems" width="300">](https://ferrous-systems.com/)
+- [Mozilla](https://www.mozilla.org/en-US/)
+- [Embark Studios](https://embark-studios.com/)
+- [freiheit.com](https://www.freiheit.com)
+
+
+
+## Features
 
 * [code completion], [imports insertion]
 * [go to definition], [implementation], [type definition]
@@ -28,6 +42,29 @@ Features:
 [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
 
+
+
 [manual]: https://rust-analyzer.github.io/manual.html
 
+## Quick start
+1. Install [rustup] the rust toolchain
+2. Install the [rust-analyzer extension]
+
+[rustup]: https://rustup.rs
+[rust-analyzer extension]: https://marketplace.visualstudio.com/items?itemName=matklad.rust-analyzer
+
+## Configuration
+
+This extension provides configurations through VSCode's configuration settings. All the configurations are under `rust-analyzer.*`.
+
+See https://rust-analyzer.github.io/manual.html#vs-code-2 for more information on VSCode specific configurations.
+
+## Communication
+
+For usage and troubleshooting requests, please use "IDEs and Editors" category of the Rust forum:
+
+https://users.rust-lang.org/c/ide/14
+
+## Documentation
+
 See https://rust-analyzer.github.io/ for more information.