Update

Author: st0012

FEATURES.md

@@ -6,8 +6,9 @@
 - [Go to Controller Action Route](#go-to-controller-action-route)
 - [Go to Controller Action View](#go-to-controller-action-view)
 - [Go to Definition](#go-to-definition)
-    - [Active Record DSLs and Associations](#active-record-dsls-and-associations-1)
-    - [Route Helpers](#route-helpers)
+    - [Go to Active Record DSL Definitions](#go-to-active-record-dsl-definitions)
+    - [Go to Active Record Associations](#go-to-active-record-associations)
+    - [Go to Route Helper Definitions](#go-to-route-helper-definitions)
 - [Ruby File Operations](#ruby-file-operations)
     - [Commands](#commands)
         - [Rails Generate](#rails-generate)
@@ -20,34 +21,61 @@
 
 ## Document Symbol
 
+Document Symbol is a way to represent the structure of a document. They are used to provide a quick overview of the
+document and to allow for quick navigation.
+
+Ruby LSP already provides document symbols for Ruby files, such as classes, modules, methods, etc. But the Rails addon
+provides additional document symbols for Rails specific features.
+
+In VS Code, you can open the document symbols view by pressing `Ctrl + Shift + O`.
+
 ### Active Record DSLs and Associations
 
-![Document Symbol for Active Record DSLs and Associations](./ruby-lsp-rails-ar-dsl-document-symbol.gif)
+Navigates between Active Record DSLs and Associations using the `Document Symbol` feature.
+
+![Document Symbol for Active Record DSLs and Associations](./ruby-lsp-rails-document-symbol-ar-model.gif)
 
 ### Active Support Test Cases
 
+Navigates between Active Support test cases using the `Document Symbol` feature.
+
 ![Document Symbol for tests](./ruby-lsp-rails-test-document-symbol.gif)
 
 ## Go to Controller Action Route
 
+Navigates to the route definition of a controller action using the `Code Lens` feature.
+
 ![Go to Controller Action Route](./ruby-lsp-rails-controller-action-to-route.gif)
 
 ## Go to Controller Action View
 
+Navigates to the view file(s) of a controller action using the `Code Lens` feature.
+
 ![Go to Controller Action View](./ruby-lsp-rails-controller-action-to-view.gif)
 
 ## Go to Definition
 
-### Active Record DSLs and Associations
+Go to definition is a feature that allows you to navigate to the definition of a symbol.
+
+In VS Code, you can trigger go to definition in 3 different ways:
+
+- Select `Go to Definition` from the context menu
+- `F12` on a symbol
+- `Cmd + Click` on a symbol
+
+In the following demos, we will use the `Cmd + Click` method to trigger go to definition.
 
-This feature enables quick navigation between related model files in Rails projects. Developers can jump between
-associations like `belongs_to` and `has_many` using IDE shortcuts, improving code exploration and productivity.
+### Go to Active Record DSL Definitions
 
-![Active Record DSLs and Associations](./ruby-lsp-rails-ar-definitions-demo.gif)
+![Go to Active Record DSL Definitions](./ruby-lsp-rails-go-to-ar-dsl-definitions.gif)
 
-### Route Helpers
+### Go to Active Record Associations
 
-![Route Helpers](./ruby-lsp-rails-go-to-route-definition.gif)
+![Go to Active Record Associations](./ruby-lsp-rails-go-to-ar-associations.gif)
+
+### Go to Route Helper Definitions
+
+![Go to Route Helper Definitions](./ruby-lsp-rails-go-to-route-definitions.gif)
 
 ## Ruby File Operations
 
@@ -70,6 +98,8 @@ the above commands.
 
 ## Run and Debug
 
+The Rails addon provides 3 ways to run and debug `ActiveSupport` tests using the `Code Lens` feature.
+
 ### Run Tests With Test Explorer
 
 ![Run Tests With Test Explorer](./ruby-lsp-rails-run.gif)