Skip to content

Update README on running and configuring the language server for user. #205

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

joewyz
Copy link
Contributor

@joewyz joewyz commented Feb 27, 2025

Issue #, if available:

Issue #170 , Issue #171

Description of changes:

Added instruction on how to run and configure the Smithy Language Server based on the idea Miles proposed from the above issues.
For running lsp section, added instruction for vscode users and neovim users.
For configuring lsp section, added documentation of fields supported by lsp and the brief explanation of two types of build files used by lsp.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@joewyz joewyz requested a review from milesziemer February 27, 2025 22:32
@joewyz joewyz requested a review from a team as a code owner February 27, 2025 22:32
@joewyz joewyz changed the title Update READM.ME on running and configuring the language server for user. Update README on running and configuring the language server for user. Feb 28, 2025
Copy link
Contributor

@milesziemer milesziemer left a comment

Choose a reason for hiding this comment

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

First round of comments

@@ -4,11 +4,179 @@
A [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
implementation for the [Smithy IDL](https://smithy.io).

Smithy is a protocol-agnostic interface definition language and set of tools for generating clients, servers, and documentation for any programming language.

## Features
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd like to somehow highlight how we support hover, completions, and diagnostics for smithy-build.json. Maybe make this say "provides the following features for the Smithy IDL", then have another list below saying what's supported for smithy-build.json.

README.md Outdated
Comment on lines 38 to 39
java -jar /path/to/unziped/folder/smithy-language-server-0.x.x.jar [port-number]
// Usually the default port-number is set to 0
Copy link
Contributor

Choose a reason for hiding this comment

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

I think we should make an update to Main.java that just defaults the port to 0

@joewyz joewyz closed this Apr 28, 2025
@joewyz joewyz deleted the joewyz/readme-update branch April 28, 2025 17:58
@joewyz joewyz restored the joewyz/readme-update branch April 28, 2025 17:58
@joewyz joewyz reopened this Apr 30, 2025
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.

None yet

2 participants