chore: update README with recommended editor plugins

Author: stainless-app[bot]

CONTRIBUTING.md

@@ -96,20 +96,17 @@ $ bundle exec rake format
 
 ## Editor Support
 
-### Solargraph
+### Ruby LSP
 
-This library includes [Solargraph](https://solargraph.org) support for both auto-completion and go to definition.
+[Ruby LSP](https://github.com/Shopify/ruby-lsp) has quite good support for go to definition, but not auto-completion.
 
-```ruby
-gem "solargraph", group: :development
-```
+This can be installed along side Solargraph.
+
+### Solargraph
 
-Note: if you had installed the gem locally using `git: "..."` or `path: "..."`, you must update your [`.solargraph.yml`](https://solargraph.org/guides/configuration) to include the path to where the gem is located:
+[Solargraph](https://solargraph.org) has quite good support for auto-completion, but not go to definition.
 
-```yaml
-include:
-  - '<path-to-repo>/lib/**/*.rb'
-```
+This can be installed along side Ruby LSP.
 
 ### Sorbet
 
@@ -119,10 +116,6 @@ include:
 
 2. For each generic type in `*.rbi` files, a spurious "Duplicate type member" error is present.
 
-### Ruby LSP
-
-The Ruby LSP has [best effort support](https://shopify.github.io/ruby-lsp/#guessed-types) for inferring type information from Ruby code, and as such it may not always be able to provide accurate type information.
-
 ## Documentation Preview
 
 To preview the documentation, run:

README.md

@@ -136,19 +136,11 @@ orb.customers.create(
 )
 ```
 
-## Editor support
-
-Some editor language services like [Solargraph](https://github.com/castwide/solargraph?tab=readme-ov-file#gem-support) or [Sorbet](https://sorbet.org/docs/rbi#the-hidden-definitions-rbi) require a manually triggered indexing step before functionalities like auto-completion and go to definition can operate.
-
-Please refer to their respective documentation for details. This library also includes a [short guide](https://github.com/orbcorp/orb-ruby/tree/main/CONTRIBUTING.md#editor-support) on how to set up various editor services for internal development.
-
-## Advanced Concepts
-
-### Model DSL
+## Model DSL
 
-This library uses a Model DSL to represent request parameters and response shapes in `lib/orb/models`.
+This library uses a simple DSL to represent request parameters and response shapes in `lib/orb/models`.
 
-The model classes service as anchor points for both toolchain readable documentation, and language service assisted navigation links. This information also allows the SDK's internals to perform translation between plain and rich data types; e.g., conversion between a `Time` instance and an ISO8601 `String`, and vice versa.
+With the right [editor plugins](https://shopify.github.io/ruby-lsp), you can ctrl-click on elements of the DSL to navigate around and explore the library.
 
 In all places where a `BaseModel` type is specified, vanilla Ruby `Hash` can also be used. For example, the following are interchangeable as arguments:
 
@@ -163,6 +155,12 @@ params = {
 }
 ```
 
+## Editor support
+
+A combination of [Shopify LSP](https://shopify.github.io/ruby-lsp) and [Solargraph](https://solargraph.org/) is recommended for non-[Sorbet](https://sorbet.org) users. The former is especially good at go to definition, while the latter has much better auto-completion support.
+
+## Advanced concepts
+
 ### Making custom/undocumented requests
 
 #### Undocumented request params