Repository navigation
docs/code-nav: Add a language support table - #2143
Open
marcleblanc2 wants to merge 7 commits into
Open
marcleblanc2 wants to merge 7 commits into
marcleblanc2 wants to merge 7 commits into
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Contributor
|
This comment has been minimized.
This comment has been minimized.
Contributor
Author
|
/spell gosyntect |
There was no single place to see which languages Sourcegraph supports, and for which features. The lists that did exist were scattered across pages and stale: the search-based list named 40 languages while the code has 47, the syntactic list was missing C and TypeScript, and the auto-indexing list was missing Rust and .NET. Syntax highlighting and symbol search had no list at all. This adds a [Language support](https://github.com/sourcegraph/docs/blob/marc/language-support-table/docs/code-navigation/language-support.mdx) page under Code Navigation, with one row per language and a checkmark column for each feature: syntax highlighting, symbol search, search-based navigation, syntactic navigation, precise navigation, and auto-indexing. A second, smaller table lists formats that are only highlighted with another language's grammar, such as SVG as XML, so they don't pad the main table. The existing lists on the Code Navigation overview, syntactic navigation, auto-indexing, and GitHub comparison pages now link to the new page, so each fact has one home. The precise indexer table stays where it is, because it carries indexer and build-tool details the new table doesn't. ## Where each column comes from The table is built from the `sourcegraph/sourcegraph` sources, not from the old docs: | Column | Source | | --- | --- | | Syntax highlighting | Tree-sitter and Syntect language maps in `internal/gosyntect/languages.go`, for every language name in go-enry (linguist) | | Symbol search | `SupportedLanguages` and the extension maps in `sourcegraph/go-ctags`, plus the scip-ctags defaults (Hack, Magik, Zig) | | Search-based navigation | `client/shared/src/codeintel/language-specs` | | Syntactic navigation | `SUPPORTED_LANGUAGES` in scip-syntax | | Precise navigation | The [indexer table](https://sourcegraph.com/docs/code-navigation/precise-code-navigation#supported-languages-and-indexers) | | Auto-indexing | Inference recipes in `internal/codeintel/autoindexing/internal/inference/lua` | The page describes the 8.1 release. On `main`, auto-indexing inference no longer covers Scala, so that checkmark needs to go when the next release ships.
Auto-indexing inference no longer covers Scala on sourcegraph/sourcegraph main, because scip-java 0.13 dropped Scala support. The checkmark would be wrong from the next release on, so the table follows main. Amp-Thread-ID: https://ampcode.com/threads/T-01a1c6f0-91a7-712d-bbd5-d52c88cd6ccc
The languages most readers look for, such as Go, Python, and TypeScript, were buried in a 129-row alphabetical table. The 15 languages with precise navigation now come first, under "Languages with full support". The other 114 follow under "Languages with partial support", without the syntactic navigation, precise navigation, and auto-indexing columns, which are empty for all of them. Amp-Thread-ID: https://ampcode.com/threads/T-01a1c6f0-91a7-712d-bbd5-d52c88cd6ccc
marcleblanc2
force-pushed
the
marc/language-support-table
branch
from
November 11, 2026 02:38
622baf9 to
b4076c7
Compare
scip-java 0.13 removed Scala support, but the indexer table still listed Scala next to Java and Kotlin with no caveat, and the new language table inherited that as a bare checkmark. Scala now has its own row in the indexer table, pointing at scip-java releases before 0.13, and the language support page links to it under the full support table.
This comment has been minimized.
This comment has been minimized.
The link check flagged the scip-java link on the Java, Kotlin row, which this branch edited. scip-java moved to the scip-code organization, and sourcegraph.com no longer serves the old repository path, so link to the repository on GitHub. Amp-Thread-ID: https://ampcode.com/threads/T-01a1c6f0-91a7-712d-bbd5-d52c88cd6ccc
sourcegraph.com no longer serves the scip-go, scip-typescript, scip-clang, scip-python, and scip-ruby repositories, so the indexer table and the manual indexing list linked to 404 pages. Link to the repositories on GitHub instead, as the monorepo copy of this page does. The scip-java getting started guide moved with the repository to scip-code.github.io. Amp-Thread-ID: https://ampcode.com/threads/T-01a1c6f0-91a7-712d-bbd5-d52c88cd6ccc
| | Crontab | ✓ | | | | ||
| | CSS | ✓ | ✓ | | | ||
| | D | ✓ | ✓ | | | ||
| | Dart | ✓ | | ✓ | |
There was a problem hiding this comment.
We do have a precise indexer for Dart, built and maintained by the folks at Workiva: https://github.com/scip-code/scip-dart
Member
|
I might be off here, but aren't our docs being migrated to the monorepo? |
This branch was successfully deployed
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.
There was no single place to see which languages Sourcegraph supports, and for which features. The lists that did exist were scattered across pages and stale: the search-based list named 40 languages while the code has 47, the syntactic list was missing C and TypeScript, and the auto-indexing list was missing Rust and .NET. Syntax highlighting and symbol search had no list at all.
This adds a Language support page under Code Navigation, with one row per language and a checkmark column for each feature: syntax highlighting, symbol search, search-based navigation, syntactic navigation, precise navigation, and auto-indexing. The 15 languages with precise navigation come first, under "Languages with full support", so readers don't have to scroll past ActionScript to find Go or TypeScript. The other 114 follow under "Languages with partial support", with only the three columns that apply to them. A last, smaller table lists formats that are only highlighted with another language's grammar, such as SVG as XML, so they don't pad the language tables.
The existing lists on the Code Navigation overview, syntactic navigation, auto-indexing, and GitHub comparison pages now link to the new page, so each fact has one home. The precise indexer table stays where it is, because it carries indexer and build-tool details the new table doesn't.
Where each column comes from
The tables are built from the
sourcegraph/sourcegraphsources, not from the old docs:internal/gosyntect/languages.go, for every language name in go-enry (linguist)SupportedLanguagesand the extension maps insourcegraph/go-ctags, plus the scip-ctags defaults (Hack, Magik, Zig)client/shared/src/codeintel/language-specsSUPPORTED_LANGUAGESin scip-syntaxinternal/codeintel/autoindexing/internal/inference/luaScala has no auto-indexing checkmark, even though 8.1 still infers Scala projects: inference on
mainno longer covers Scala, because scip-java 0.13 dropped Scala support. Scala keeps its precise navigation checkmark, because earlier scip-java releases still index it. The page says so under the full support table, and Scala now has its own row in the indexer table on the precise navigation page, pointing at scip-java releases before 0.13.The indexer table and the manual indexing list above it also linked to indexer repositories that sourcegraph.com no longer serves. Those links now point at the repositories on GitHub.