diff --git a/README.md b/README.md
index a6dbe79..64ff183 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,6 @@
Ruby LSP RSpec is a [Ruby LSP](https://github.com/Shopify/ruby-lsp) addon for displaying CodeLens for RSpec tests.
-
-
## Installation
To install, add the following line to your application's Gemfile:
@@ -19,14 +17,36 @@ end
After running `bundle install`, restart Ruby LSP and you should start seeing CodeLens in your RSpec test files.
-## Usages (with VS Code)
+## Features
+
+### CodeLens
+
+1. When clicking `Run`, the test(s) will be executed via the Test Explorer
+ - However, deeply nested tests may not be displayed correctly at the moment
+2. When clicking `Run In Terminal`, a test command will be generated in the terminal
+3. When clicking `Debug`, the test(s) will be executed with VS Code debugger enabled (requires the [`debug`](https://github.com/ruby/debug) gem)
+ - [Learn how to set breakpoints in VS Code](https://code.visualstudio.com/docs/editor/debugging#_breakpoints)
+
+
+
+### Document Symbols
+
+Document Symbols can be triggered by:
+
+- Typing `@` in VS Code's command palette
+- Pressing `Cmd+Shift+O`
+
+
+
+### Go to definition
+
+In VS Code this feature can be triggered by one of the following methods:
-1. When clicking `Run`, the test(s) will be executed via the Test Explorer.
- - However, deeply nested tests may not be displayed correctly at the moment.
-2. When clicking `Run In Terminal`, a test command will be generated in the terminal.
-3. When clicking `Debug`, the test(s) will be executed with VS Code debugger enabled (requires the [`debug`](https://github.com/ruby/debug) gem).
- - [Learn how to set breakpoints in VS Code](https://code.visualstudio.com/docs/editor/debugging#_breakpoints).
+- `Right click` on the target, and then select `Go to Definition`
+- Placing the cursor on the target, and then hit `F12`
+- `Command + click` the target
+
## Development
diff --git a/misc/example.gif b/misc/code-lens.gif
similarity index 100%
rename from misc/example.gif
rename to misc/code-lens.gif
diff --git a/misc/document-symbol-example.gif b/misc/document-symbol.gif
similarity index 100%
rename from misc/document-symbol-example.gif
rename to misc/document-symbol.gif
diff --git a/misc/go-to-definition.gif b/misc/go-to-definition.gif
new file mode 100644
index 0000000..18fc928
Binary files /dev/null and b/misc/go-to-definition.gif differ