docs: Add `linkedProjects` section to Rust docs (#19954)

Gherman and Marshall Bowers created 1 year ago

Related to #19897

Adds a section about multi-project workspaces and how to configure
rust-analyzer to diagnose them even if the cargo workspace does not list
them

Release Notes:

- N/A

---------

Co-authored-by: Marshall Bowers <[e-mail]>

Change summary

docs/src/languages/rust.md | 17 +++++++++++++++++
1 file changed, 17 insertions(+)

Detailed changes

docs/src/languages/rust.md

@@ -163,6 +163,23 @@ Here's a snippet for Zed settings.json (the language server will restart automat
 }
 ```
 
+### Multi-project workspaces
+
+If you want rust-analyzer to analyze multiple Rust projects in the same folder that are not listed in `[members]` in the Cargo workspace,
+you can list them in `linkedProjects` in the local project settings:
+
+```json
+{
+  "lsp": {
+    "rust-analyzer": {
+      "initialization_options": {
+        "linkedProjects": ["./path/to/a/Cargo.toml", "./path/to/b/Cargo.toml"]
+      }
+    }
+  }
+}
+```
+
 ### Snippets
 
 There's a way get custom completion items from rust-analyzer, that will transform the code according to the snippet body: