7837: Add more information to VSCode extenstion README r=matklad a=IceSentry

A lot of these are duplicated from the documentation or main README. While it's unfortunate to have duplicated information, the current VSCode page is very barebones and doesn't offer much confidence. 

This updated README offers a few more links and follows a structure similar to the official rust extension and other popular vscode extensions. The additions are, as much as possible specific to the vscode extension and not rust-analyzer as a LSP.

The note about not using the official extension is also right there at the top because that's a common issue people have when trying it out. 

I added the sponsor section since it's common in other extensions README, but I'm not sure if it's necessary

Co-authored-by: Charles Giguere <IceSentry@users.noreply.github.com>
Co-authored-by: cgiguere <c.giguere42@gmail.com>
This commit is contained in:
bors[bot] 2021-03-02 12:19:50 +00:00 committed by GitHub
commit f5c25f6b83
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -2,18 +2,36 @@
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.
* [code completion], [imports insertion]
* [go to definition], [implementation], [type definition]
* [find all references], [workspace symbol search], [rename]
* [types and documentation on hover]
* [inlay hints]
* [semantic syntax highlighting]
* a lot of [assist(code actions)]
* apply suggestions from errors
* ... and many more, checkout the [manual] to see them all
## 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)
If you want to sponsor:
- [OpenCollective](https://opencollective.com/rust-analyzer/)
- [Github Sponsors](https://github.com/sponsors/rust-analyzer)
## Features
- [code completion], [imports insertion]
- [go to definition], [implementation], [type definition]
- [find all references], [workspace symbol search], [rename]
- [types and documentation on hover]
- [inlay hints]
- [semantic syntax highlighting]
- a lot of [assist(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
@ -30,4 +48,26 @@ Features:
[manual]: https://rust-analyzer.github.io/manual.html
See https://rust-analyzer.github.io/ for more information.
## Quick start
1. Install [rustup]
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.