Skip to content

Document VS Code Ruby LSP setup - #23995

Merged
MikeMcQuaid merged 1 commit into
Homebrew:mainfrom
HaraldNordgren:document-ruby-lsp-vscode-setup
Sep 16, 2026
Merged

MikeMcQuaid merged 1 commit into
Homebrew:mainfrom
HaraldNordgren:document-ruby-lsp-vscode-setup

Conversation

@HaraldNordgren

@HaraldNordgren HaraldNordgren commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

rubyVersionManager, customRubyCommand and bundleGemfile in .vscode/settings.json are "machine"-scoped, so VS Code never actually applies them from a workspace's settings.json (Shopify/ruby-lsp#4120 would fix this upstream). Nothing in the repo told contributors this, so anyone with the Ruby LSP extension just hit a bare zsh: parse error near '&&' with no path to a fix. This documents the workaround.


  • Have you followed our Contributing guidelines?
  • Have you checked for other open Pull Requests for the same change?
  • Have you explained what your changes do? Performance claims (e.g. "this is faster") must include brew benchmark results.
  • Have you explained why you'd like these changes included, not just what they do?
  • For bug fixes, have you given step-by-step brew commands to reproduce the bug?
  • Have you written new tests (excluding integration tests)? Here's an example.
  • Have you successfully run brew lgtm (style, typechecking and tests) locally?

  • I did not use AI/LLM to create this PR, or I disclosed the tool/model below and reviewed its output; I did not attribute commits to AI and will answer maintainer questions and review comments myself without AI/LLM.

Disclosure: drafted with Claude Code assistance. I reviewed the change and reasoning and will answer questions myself.


@HaraldNordgren
HaraldNordgren force-pushed the document-ruby-lsp-vscode-setup branch from a165f7f to 70eebf5 Compare September 16, 2026 07:06

@MikeMcQuaid MikeMcQuaid left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this quite makes sense being in CONTRIBUTING. Maybe in FAQ or Tips and Tricks section in docs?

@HaraldNordgren
HaraldNordgren force-pushed the document-ruby-lsp-vscode-setup branch from 70eebf5 to 779fd2a Compare September 16, 2026 08:01
@HaraldNordgren

Copy link
Copy Markdown
Contributor Author

Good point, moved to the existing VS Code section in docs/Tips-and-Tricks.md instead.

@HaraldNordgren
HaraldNordgren force-pushed the document-ruby-lsp-vscode-setup branch 2 times, most recently from e280891 to b369f4a Compare September 16, 2026 08:04
rubyVersionManager, customRubyCommand and bundleGemfile in
.vscode/settings.json are "machine"-scoped, so VS Code never applies
them from a workspace's settings.json. Nothing in the repo told
contributors this, so anyone with the Ruby LSP extension just hit a
bare "zsh: parse error near '&&'" with no path to a fix.
@HaraldNordgren
HaraldNordgren force-pushed the document-ruby-lsp-vscode-setup branch from b369f4a to 32eba94 Compare September 16, 2026 08:11

@MikeMcQuaid MikeMcQuaid left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@MikeMcQuaid
MikeMcQuaid added this pull request to the merge queue Sep 16, 2026
Merged via the queue into Homebrew:main with commit 0cf81cb Sep 16, 2026
52 checks passed
@HaraldNordgren
HaraldNordgren deleted the document-ruby-lsp-vscode-setup branch September 16, 2026 13:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants