Skip to content

Add hover documentation for 'break' keyword #3587

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 17, 2025

Conversation

mikeygough
Copy link
Contributor

@mikeygough mikeygough commented Jun 6, 2025

Step towards #2227

This PR adds hover documentation for the 'break' keyword by following a pattern established by hover documentation for the 'yield' keyword.

This keyword documentation was written by AI following Shopify's Ruby style guide. It has been reviewed by myself but could benefit from additional reviews!

Motivation

We can deliver a better Ruby programming experience if developers can hover over built-in keywords to learn more about how they work!

Implementation

This implementation follows a pattern established by the yield keyword. It adds a key value pair to the KEYWORD_DOCS' hash inside static_docs.rb, writes a keyword specific markdown file that goes into a deeper explanation and extends hover.rb` to handle keyword specific hover events.

Automated Tests

Run dev t

Manual Tests

Start the Ruby LSP. Use the keyword and checkout the tooltip + related documentation!

@mikeygough mikeygough requested a review from a team as a code owner June 6, 2025 16:19
Copy link

graphite-app bot commented Jun 6, 2025

How to use the Graphite Merge Queue

Add the label graphite-merge to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

@mikeygough mikeygough added enhancement New feature or request server This pull request should be included in the server gem's release notes labels Jun 6, 2025
@mikeygough mikeygough requested a review from vinistock June 6, 2025 16:20
@mikeygough mikeygough self-assigned this Jun 6, 2025
Copy link
Member

@vinistock vinistock left a comment

Choose a reason for hiding this comment

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

Awesome! Thanks

@vinistock vinistock merged commit 452d2d7 into main Jun 17, 2025
38 checks passed
@vinistock vinistock deleted the add-hover-documentation-for-break-keyword branch June 17, 2025 20:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request server This pull request should be included in the server gem's release notes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants