Docs: add the language servers missing from the supported-language lists#1763
Open
xormania wants to merge 1 commit into
Open
Docs: add the language servers missing from the supported-language lists#1763xormania wants to merge 1 commit into
xormania wants to merge 1 commit into
Conversation
Several backends that are registered and tested were absent from the user-facing lists: six from the README (pascal, qml, rego, systemverilog, terraform, vue), six from the Language Support docs page (matlab, powershell, rego, systemverilog, terraform, toml), and two from the commented language-server list in the project template (python_basedpyright, qml). The drift is long-standing and runs in both directions: matlab, powershell and toml reached the README but never the docs page; pascal, vue and qml reached the docs page but never the README; terraform, rego and systemverilog reached neither, the oldest of them since 2025-07-06. The two template omissions are the most recent, from oraios#1705 and oraios#1635. The guide's Documentation step does ask for the README and the docs page, so most of this was missed rather than unspecified; it does not mention the project template at all. The setup notes on the new docs-page entries name the versions Serena actually pins, taken from the corresponding language-server modules: MATLAB extension 1.3.9, PowerShell Editor Services 4.4.0 and PSScriptAnalyzer 1.25.0, Verible v0.0-4051-g9fdb4057, terraform-ls 0.36.5, and Taplo 0.10.0. The PowerShell entry mentions both automatic installations, since enabling that backend also runs Save-Module against the user's configured PowerShell repository. The new Regal link points at open-policy-agent/regal, the current canonical repository; StyraInc/regal still redirects there, and the adapter and the CI workflow have not been changed. The template block is refreshed from scripts/print_language_list.py, which is why its column widths change: python_basedpyright is longer than any identifier the previous list contained. The pointer directly below it still named the Language enum, renamed to LanguageServerId in d2cf18d.
There was a problem hiding this comment.
Pull request overview
This PR fixes documentation drift by adding already-supported language servers to the user-facing “supported languages” lists (README and docs) and updating the commented language-server list in the project template to match the current LanguageServerId set.
Changes:
- Expand the README language list to include Pascal, QML, Rego, SystemVerilog, Terraform, and Vue.
- Expand the Language Support docs page with missing entries and setup notes (including pinned versions for MATLAB, PowerShell, SystemVerilog, Terraform, and TOML).
- Refresh the project template’s commented language-server list and update the pointer to
LanguageServerId, plus add a concise changelog entry.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| src/serena/resources/project.template.yml | Updates the commented language-server identifier list and points readers to the LanguageServerId enum. |
| README.md | Adds missing languages to the “supported languages” list in the README. |
| docs/01-about/020_programming-languages.md | Adds missing languages and concrete setup/version notes to the Language Support docs page. |
| CHANGELOG.md | Notes the documentation/template fix in the Unreleased changelog. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Several backends that are registered and tested were absent from the user-facing lists: six from the README (pascal, qml, rego, systemverilog, terraform, vue), six from the Language Support docs page (matlab, powershell, rego, systemverilog, terraform, toml), and two from the commented language-server list in the project template (python_basedpyright, qml).
The drift is long-standing and runs in both directions: matlab, powershell and toml reached the README but never the docs page; pascal, vue and qml reached the docs page but never the README; terraform, rego and systemverilog reached neither, the oldest of them since 2025-07-06. The two template omissions are the most recent, from #1705 and #1635. The guide's Documentation step does ask for the README and the docs page, so most of this was missed rather than unspecified; it does not mention the project template at all.
The setup notes on the new docs-page entries name the versions Serena actually pins, taken from the corresponding language-server modules: MATLAB extension 1.3.9, PowerShell Editor Services 4.4.0 and PSScriptAnalyzer 1.25.0, Verible v0.0-4051-g9fdb4057, terraform-ls 0.36.5, and Taplo 0.10.0. The PowerShell entry mentions both automatic installations, since enabling that backend also runs Save-Module against the user's configured PowerShell repository.
The new Regal link points at open-policy-agent/regal, the current canonical repository; StyraInc/regal still redirects there, and the adapter and the CI workflow have not been changed.
The template block is refreshed from scripts/print_language_list.py, which is why its column widths change: python_basedpyright is longer than any identifier the previous list contained. The pointer directly below it still named the Language enum, renamed to LanguageServerId in d2cf18d.
Checklist
CONTRIBUTING.mdregarding the scope of PRs.CHANGELOG.md, which concisely describes the change.