cursorless icon indicating copy to clipboard operation
cursorless copied to clipboard

docs: add per-language pages

Open josharian opened this issue 2 years ago • 2 comments

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 https://github.com/cursorless-dev/cursorless/pull/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
  • [ ] https://github.com/cursorless-dev/cursorless/issues/2632
  • [ ] Re-add languages section to our crawler (ie roll back https://github.com/cursorless-dev/cursorless/pull/2633 and follow directions in https://www.cursorless.org/docs/contributing/documentation-search/#tweaking-crawling--indexing--ranking)

dependent on https://github.com/cursorless-dev/cursorless/issues/2632

josharian avatar Jul 16 '23 19:07 josharian

Started dropping Go notes for now in a dedicated Go wiki page.

josharian avatar Aug 15 '23 18:08 josharian

Also started a Python dedicated page https://github.com/cursorless-dev/cursorless/wiki/Language:-Python

saidelike avatar Sep 08 '23 08:09 saidelike