Open
Description
This would be more welcoming, and make users confident that their language of choice is spoken. It'd also be a good place to list relevant scopes, as well as commentary about how those scopes are interpreted in their language. Maybe some examples as well.
The list of relevant scopes would be duplicated in the per-scope docs (#1641), so it should probably be generated from a single source of truth. (Maybe the commentary and examples should be too?)
An initial version of this shipped in #2451. From there, we'd like to do the following:
- Re-organize each support section to have entries for each scope, rather than a flat list of all facets irrespective of scope
- Use the description or a human-readable name of each facet instead of the raw id
- Migrate all relevant recorded tests to next-gen facet tests #2632
- Re-add languages section to our crawler (ie roll back docs: Exclude language docs from crawler #2633 and follow directions in https://www.cursorless.org/docs/contributing/documentation-search/#tweaking-crawling--indexing--ranking)
dependent on
#2632