chore: Update docs

Author: tommasongr

README.md

@@ -9,8 +9,6 @@ Connect Nova to **[Solargraph](https://solargraph.org)** language server. Solarg
 
 ## Features
 
-### Supported
-
 - Code completions
 - Go to definition
 - Diagnostics (RuboCop required)
@@ -21,40 +19,52 @@ Connect Nova to **[Solargraph](https://solargraph.org)** language server. Solarg
 - Workspace symbols
 - Rename symbol
 
-### Not supported
+## Setup
 
-- Code folding
-- Search documentation
-- On type formatting
+Start by installing the Ruby gem:
 
-## Requirements
+```
+$ gem install solargraph
+```
 
-You need to install the Ruby gem:
+Then install the documentation for the current version of Ruby:
 
 ```
-$ gem install solargraph
+$ solargraph download-core
+```
+
+Finally generate the documentation for the installed gems:
+
+```
+$ yard gems
 ```
 
-### Run from bundle
+### Ruby on Rails setup
+
+Follow this [guide](https://solargraph.org/guides/rails) to configure Solargraph so it can pair well with Rails.
+
+Consider installing this [plugin](https://github.com/iftheshoefritz/solargraph-rails) too.
+
+## Launch from bundle
 
-If you want you can use the Solargraph version installed in your project bundle.
+Alternatively, the extension can also launch Solargraph from the project bundle.
 
 Start by adding the gem to the development group:
 
 ```
 $ bundle add solargraph --group=development --require=false
 ```
 
-Then you can check the `Use Bundler` config in the extension or project settings.
+Then check the `Use Bundler` config in the extension or project settings.
 
-> Warning: If you have the `Use Bundler` config checked but you have not added Solargraph to the bundle, the extension will raise an error.
+> Warning: If the `Use Bundler` config is checked but Solargraph is not in the bundle, the extension will raise an error.
 
 ## Diagnostics & Formatting
 
 Solargraph uses [RuboCop](https://rubocop.org) to provide diagnostics and formatting. Make sure to install that gem too.
 
-When you have RuboCop installed you can opt-in for diagnostics and formatting from the extension or project settings.
+When RuboCop is installed you can opt-in for diagnostics and formatting from the extension or project settings.
 
 ## Find references & Workspace symbols
 
-You can see the workspace symbols and find references results in the Nova's Solargraph sidebar.
+Workspace symbols and find references results are going to be displayed in the Solargraph sidebar inside Nova.

extension.json

@@ -2,7 +2,7 @@
 	"identifier": "com.tommasonegri.solargraph",
 	"name": "Solargraph",
 	"organization": "Tommaso Negri",
-	"description": "A Ruby language server featuring code completion, intellisense, and inline documentation.",
+	"description": "A Ruby language server featuring code completion, intellisense, and inline documentation",
 	"version": "1.0",
 
 	"license": "MIT",