diff --git a/CHANGELOG.md b/CHANGELOG.md index b92e309a671..39e8a5620b4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,7 @@ ## 2026 +- 2026-08-30: Overhauled the user documentation with generated and grouped action, modifier, and scope reference pages, richer descriptions and examples, dedicated paired-delimiter and target guides, and a streamlined landing page. ([#3303](https://github.com/cursorless-dev/cursorless/pull/3303); [#3304](https://github.com/cursorless-dev/cursorless/pull/3304); [#3305](https://github.com/cursorless-dev/cursorless/pull/3305); [#3306](https://github.com/cursorless-dev/cursorless/pull/3306); [#3307](https://github.com/cursorless-dev/cursorless/pull/3307); [#3308](https://github.com/cursorless-dev/cursorless/pull/3308); [#3309](https://github.com/cursorless-dev/cursorless/pull/3309); [#3310](https://github.com/cursorless-dev/cursorless/pull/3310); [#3311](https://github.com/cursorless-dev/cursorless/pull/3311); [#3312](https://github.com/cursorless-dev/cursorless/pull/3312); [#3313](https://github.com/cursorless-dev/cursorless/pull/3313); [#3314](https://github.com/cursorless-dev/cursorless/pull/3314); [#3315](https://github.com/cursorless-dev/cursorless/pull/3315); [#3316](https://github.com/cursorless-dev/cursorless/pull/3316)) - 2026-05-03: Add support for if and for statements in Talon-script. [`#3274`](https://github.com/cursorless-dev/cursorless/pull/3274) - 2026-03-12: Added `userColor3` and `userColor4` as additional user-configurable hat colors. They are disabled by default until you enable and name them. ([#3206](https://github.com/cursorless-dev/cursorless/pull/3206)) - 2026-03-11: Moved scope tests out of VSCode so they can run as regular unit tests with faster local and CI feedback. ([#3210](https://github.com/cursorless-dev/cursorless/pull/3210)) diff --git a/packages/app-vscode/package.json b/packages/app-vscode/package.json index e6362a98624..21c4614c3b4 100644 --- a/packages/app-vscode/package.json +++ b/packages/app-vscode/package.json @@ -738,7 +738,7 @@ "additionalProperties": false }, "cursorless.hatEnablement.shapes": { - "markdownDescription": "Which shapes to enable. See the [docs](https://www.cursorless.org/docs/#shapes) if you're not sure which shape name corresponds to which hat shape.", + "markdownDescription": "Which shapes to enable. See the [docs](https://www.cursorless.org/docs/user/targets#shapes) if you're not sure which shape name corresponds to which hat shape.", "type": "object", "order": 3, "properties": { diff --git a/packages/app-web-docs/sidebarItemsGenerator.ts b/packages/app-web-docs/sidebarItemsGenerator.ts index 8415146947f..ab045c213d3 100644 --- a/packages/app-web-docs/sidebarItemsGenerator.ts +++ b/packages/app-web-docs/sidebarItemsGenerator.ts @@ -20,6 +20,7 @@ const items: (Group | string)[] = [ "Actions", "Modifiers", "Scopes", + "Targets", "Destinations", "Paired delimiters", ], diff --git a/packages/app-web-docs/src/docs/user/README.md b/packages/app-web-docs/src/docs/user/README.md index 69d82dc40dd..2816ad1059b 100644 --- a/packages/app-web-docs/src/docs/user/README.md +++ b/packages/app-web-docs/src/docs/user/README.md @@ -4,202 +4,28 @@ slug: / # Cursorless -Welcome to Cursorless! You may find it helpful to start with the [tutorial videos](https://www.youtube.com/watch?v=5mAzHGM2M0k&list=PLXv2sppxeoQZz49evjy4T0QJRIgc_JPqs). +Welcome to Cursorless! If you're new, start with the [tutorial videos](https://www.youtube.com/watch?v=5mAzHGM2M0k&list=PLXv2sppxeoQZz49evjy4T0QJRIgc_JPqs) or the [how-to guides](./how-to.md). -This guide assumes you've already [installed Cursorless](installation.md). +This guide assumes you've already [installed Cursorless](./installation.md). -Once you understand the concepts, you can pull up a cheatsheet for reference by saying either `"cursorless reference"` or `"cursorless cheatsheet"` with VSCode focused. +Once you understand the concepts, you can pull up a cheatsheet by saying `"cursorless reference"` or `"cursorless cheatsheet"` with VSCode focused. You can return to these docs by saying `"cursorless docs"` or `"cursorless help"` within VSCode. -You can get back to these docs by saying `"cursorless docs"`, `"cursorless help"` within VSCode. - -Note: If you'd like to customize any of the spoken forms, please see [Customization](customization.md). +To change any spoken forms, see [Customization](./customization.md). ## Overview -Every cursorless command consists of an action performed on a target. For example, the command `"chuck bat"` deletes the token with a hat over the `b`. In this command, the action is `"chuck"` (delete), and the target is `"bat"`. There are no actions without at least one target. - -![`"chuck bat"`](images/chuckBat.gif) - -## Targets - -There are two types of targets: primitive targets and compound targets. Compound targets are constructed from primitive targets, so let's begin with primitive targets. - -### Primitive targets - -A primitive target consists of a mark and one or more optional modifiers. The simplest primitive targets just consist of a mark without any modifiers, so let's begin with those - -#### Marks - -There are several types of marks: - -##### Decorated symbol - -This is the first type of mark you'll notice when you start using cursorless. You'll see that for every token on the screen, one of its characters will have a hat on top of it. We can refer to the given token by saying the name of the character that has a hat, along with the color if the hat is not gray, and the shape of the hat if the hat is not the default dot: - -- `"air"` (if the color is gray) -- `"blue bat"` -- `"blue dash"` -- `"blue five"` -- `"fox bat"` -- `"blue fox bat"` - -The general form of this type of mark is: - -`"[] [] ( | | )"` - -Combining this with an action, we might say `"take blue air"` to select the token containing letter `'a'` with a blue hat over it. - -###### Colors - -The following colors are supported. Note that to target the default (gray) hat you don't need to specify a color. - -| Spoken form | Color | Internal ID | Enabled by default? | -| ---------------- | ------- | ------------ | ------------------- | -| N/A | grey | `default` | ✅ | -| `"blue"` | blue | `blue` | ✅ | -| `"green"` | green | `green` | ✅ | -| `"red"` | red | `red` | ✅ | -| `"pink"` | pink | `pink` | ✅ | -| `"yellow"` | yellow | `yellow` | ✅ | -| `"navy"` | navy | `userColor1` | ❌ | -| `"apricot"` | apricot | `userColor2` | ❌ | -| `"user color 3"` | user 3 | `userColor3` | ❌ | -| `"user color 4"` | user 4 | `userColor4` | ❌ | - -You can enable or disable colors in your VSCode settings, by searching for [`cursorless.hatEnablement.colors`](vscode://settings/cursorless.hatEnablement.colors) and checking the box next to the internal ID for the given shape as listed above. To navigate to your VSCode settings, either say "show settings", or go to File --> Preferences --> Settings. - -You can also tweak the visible colors for any of these colors in your VSCode settings, by searching for [`cursorless.colors`](vscode://settings/cursorless.colors) and changing the hex color code next to the internal ID for the given shape as listed above. Note that you can configure different colors for dark and light themes. See our [visual accessibility guide](visual-accessibility.md) for more on visual accessibility. - -If you find these color names unintuitive / tough to remember, their -spoken forms can be [customized](customization.md) like any other spoken form -in Cursorless. If you change a spoken form to be more than one syllable, you -can change the penalty in the [`cursorless.hatPenalties.colors`](vscode://settings/cursorless.hatPenalties.colors) setting to the -number of syllables you use, so that Cursorless can optimize hat allocation to -minimize syllables. - -###### Shapes - -The following shapes are supported. Note that to target the default (dot) shape you don't need to specify a shape. - -| Spoken form | Shape | Internal ID | Enabled by default? | -| ----------- | ------------------------------------------------------------------ | ------------ | ------------------- | -| N/A | ![Default](../../../../../resources/images/hats/default.svg) | `default` | ✅ | -| `"bolt"` | ![Bolt](../../../../../resources/images/hats/bolt.svg) | `bolt` | ❌ | -| `"curve"` | ![Curve](../../../../../resources/images/hats/curve.svg) | `curve` | ❌ | -| `"fox"` | ![Fox](../../../../../resources/images/hats/fox.svg) | `fox` | ❌ | -| `"frame"` | ![Frame](../../../../../resources/images/hats/frame.svg) | `frame` | ❌ | -| `"play"` | ![Play](../../../../../resources/images/hats/play.svg) | `play` | ❌ | -| `"wing"` | ![Wing](../../../../../resources/images/hats/wing.svg) | `wing` | ❌ | -| `"hole"` | ![Hole](../../../../../resources/images/hats/hole.svg) | `hole` | ❌ | -| `"ex"` | ![Ex](../../../../../resources/images/hats/ex.svg) | `ex` | ❌ | -| `"cross"` | ![Crosshairs](../../../../../resources/images/hats/crosshairs.svg) | `crosshairs` | ❌ | -| `"eye"` | ![Eye](../../../../../resources/images/hats/eye.svg) | `eye` | ❌ | - -You can enable or disable shapes in your VSCode settings, by searching for [`cursorless.hatEnablement.shapes`](vscode://settings/cursorless.hatEnablement.shapes) and checking the box next to the internal ID for the given shape as listed above. To navigate to your VSCode settings, either say "show settings", or go to File --> Preferences --> Settings. - -If you find these shape names unintuitive / tough to remember, their -spoken forms can be [customized](customization.md) like any other spoken form -in cursorless. If you change a spoken form to be more than one syllable, you -can change the penalty in the [`cursorless.hatPenalties.shapes`](vscode://settings/cursorless.hatPenalties.shapes) setting to the -number of syllables you use, so that cursorless can optimize hat allocation to -minimize syllables. - -##### `"this"` - -The word `"this"` can be used as a mark to refer to the current cursor(s) or selection(s) as a target. Note that when combined with a modifier, the `"this"` mark can be omitted, and it will be implied. - -- `"chuck this"` -- `"take funk this"` -- `"pre funk"` -- `"chuck line"` - -Note that if you say `"this"` with an empty selection, it refers to the token containing your cursor. - -##### `"that"` +Every Cursorless command consists of an action performed on a target. For example, `"chuck bat"` deletes the token with a hat over the `b`: `"chuck"` is the action and `"bat"` is the target. -The word `"that"` can be used as a mark to refer to the target of the previous cursorless command. +![`"chuck bat"`](./images/chuckBat.gif) -- `"pre that"` -- `"round wrap that"` - -##### `"row "` - -The word `"row"` followed by a number can be used to refer to a line by its line number. Note that the line numbers are modulo 100, meaning that you only say the last two digits of the line number. Also note that the line must be visible within the viewport. - -- `"chuck row twenty four"` -- `"post row eighty nine"` -- `"pour row eleven"` - -##### `"up "` / `"down "` - -The word `"up"` or `"down"` followed by a number can be used to refer to the line that is `` lines above or below the cursor. The line may be outside of the viewport. In the case of multiple selections, this mark only refers to the line relative to the primary selection. You can turn on relative line numbers in the VSCode settings to make these marks easier to use. - -- `"copy up one"` -- `"comment down two"` - -#### Modifiers - -Modifiers change a target's extent or interpretation. See the [modifier reference](./modifiers/README.md) for the available modifiers and their detailed behavior. - -Scopes expand a target to a containing text or syntax-tree structure. See the [scope reference](./scopes/README.md) for the available scopes, and use the [scope visualizer](./scope-visualizer.md) to explore the scopes supported in your code. - -### Compound targets - -Individual targets can be combined into compound targets to make bigger targets or refer to multiple selections at the same time. - -#### Range targets - -A range target uses one primitive target as its start and another as its end to form a range from the start to the end. For example, `"air past bat"` refers to the range from the token with a hat over its 'a' to a token with a hat over its 'b'. - -Note that if the first target is omitted, the start of the range will be the current selection(s). - -- `"take [blue] air past [green] bat"` -- `"take past [blue] air"` -- `"take funk [blue] air past [blue] bat"` (note end of range inherits `"funk"`) -- `"take funk [blue] air past token [blue] bat"` -- `"take past end of line"` -- `"take past start of line"` -- `"take [blue] air past end of line"` - -eg: -`take blue air past green bat` -Selects the range from the token containing letter 'a' with a blue hat past the token containing letter 'b' with a green hat. - -##### Vertical ranges - -The `"slice"` range modifier is used to refer to multiple targets that are vertically aligned. It is commonly used with the `"pre"` action to add multiple cursors to the editor. Each cursor is inserted at the same column on each row requested within the command. - -- `"pre slice past "`: Add cursors from the first target through to the second target's line(inclusive end) -- `"pre slice "`: Shortened version of above `"slice past"` command -- `"pre slice until "`: Add cursors until the second target's line(non-inclusive end) -- `"pre slice between "`: Add cursors between first and second target's lines(non-inclusive start and end) - -For example: - -- `"pre air slice bat"`: Places cursors at the same position on every line (inclusive) between token with hat over the `a` and token with the hat over the `b`. The position will be the start of the token with a hat over the `a` -- `"chuck tail air slice end of block"`: Delete the end of every line from air through the end of its non-empty line block. - -##### `"every"` ranges - -If the range target begins with `"every "`, eg `"take every line air past bat"`, then you will end up with one target for each instance of `` in the range. For example, `"post every line air past bat"` will put a cursor at the end of every line from the line containing the token with a hat over the letter `a` to the line containing the token with a hat over the letter `b`. - -These `"every"` ranges also play nicely with exclusive ranges, eg `"take every funk air until bat"` will select every function starting from the function containing the token with a hat over the letter `a` up until, but not including, the function containing the token with a hat over the letter `b`. - -#### List targets - -In addition to range targets, cursorless supports list targets, which allow you to refer to multiple targets at the same time. When combined with the `"take"` action, this will result in multiple cursors, for other actions, such as `"chuck"` the action will be applied to all the different targets at once. +## Actions -- `"take [blue] air and [green] bat"` -- `"take funk [blue] air and [green] bat"` (note second target inherits `"funk"`) -- `"take funk [blue] air and token [green] bat"` -- `"take air and bat past cap"` +An action determines what happens to a target. For example, `"chuck air"` removes the target, while `"take air"` selects it. -eg: -`take blue air and green bat` -Selects both the token containing letter 'a' with a blue hat AND the token containing 'b' with a green hat. +See the [action reference](./actions/README.md) for the complete list of actions, syntax, behavior, and examples. -## Actions +## Targets -Every Cursorless command combines an action with a target. The action determines what happens to the target. For example, `"chuck air"` removes the target, while `"take air"` selects it. +A target identifies the text or position that a command acts on. Targets can refer to a single token or selection, a containing scope, a range, or a list of several targets. -See the [action reference](./actions/README.md) for the complete list of actions, syntax, behavior, and examples. +See the [target guide](./targets.md) to learn how marks, modifiers, scopes, ranges, and lists combine to form targets. For detailed lookup, use the [modifier reference](./modifiers/README.md) and [scope reference](./scopes/README.md). diff --git a/packages/app-web-docs/src/docs/user/targets.md b/packages/app-web-docs/src/docs/user/targets.md new file mode 100644 index 00000000000..07e53a6a6b1 --- /dev/null +++ b/packages/app-web-docs/src/docs/user/targets.md @@ -0,0 +1,177 @@ +# Targets + +There are two types of targets: primitive targets and compound targets. Compound targets are constructed from primitive targets, so let's begin with primitive targets. + +## Primitive targets + +A primitive target consists of a mark and one or more optional modifiers. The simplest primitive targets consist only of a mark, so let's begin with those. + +### Marks + +There are several types of marks: + +#### Decorated symbol + +This is the first type of mark you'll notice when you start using cursorless. You'll see that for every token on the screen, one of its characters will have a hat on top of it. We can refer to the given token by saying the name of the character that has a hat, along with the color if the hat is not gray, and the shape of the hat if the hat is not the default dot: + +- `"air"` (if the color is gray) +- `"blue bat"` +- `"blue dash"` +- `"blue five"` +- `"fox bat"` +- `"blue fox bat"` + +The general form of this type of mark is: + +`"[] [] ( | | )"` + +Combining this with an action, we might say `"take blue air"` to select the token containing letter `'a'` with a blue hat over it. + +##### Colors + +The following colors are supported. Note that to target the default (gray) hat you don't need to specify a color. + +| Spoken form | Color | Internal ID | Enabled by default? | +| ---------------- | ------- | ------------ | ------------------- | +| N/A | grey | `default` | ✅ | +| `"blue"` | blue | `blue` | ✅ | +| `"green"` | green | `green` | ✅ | +| `"red"` | red | `red` | ✅ | +| `"pink"` | pink | `pink` | ✅ | +| `"yellow"` | yellow | `yellow` | ✅ | +| `"navy"` | navy | `userColor1` | ❌ | +| `"apricot"` | apricot | `userColor2` | ❌ | +| `"user color 3"` | user 3 | `userColor3` | ❌ | +| `"user color 4"` | user 4 | `userColor4` | ❌ | + +You can enable or disable colors in your VSCode settings, by searching for [`cursorless.hatEnablement.colors`](vscode://settings/cursorless.hatEnablement.colors) and checking the box next to the internal ID for the given shape as listed above. To navigate to your VSCode settings, either say "show settings", or go to File --> Preferences --> Settings. + +You can also tweak the visible colors for any of these colors in your VSCode settings, by searching for [`cursorless.colors`](vscode://settings/cursorless.colors) and changing the hex color code next to the internal ID for the given shape as listed above. Note that you can configure different colors for dark and light themes. See our [visual accessibility guide](./visual-accessibility.md) for more on visual accessibility. + +If you find these color names unintuitive / tough to remember, their +spoken forms can be [customized](./customization.md) like any other spoken form +in Cursorless. If you change a spoken form to be more than one syllable, you +can change the penalty in the [`cursorless.hatPenalties.colors`](vscode://settings/cursorless.hatPenalties.colors) setting to the +number of syllables you use, so that Cursorless can optimize hat allocation to +minimize syllables. + +##### Shapes + +The following shapes are supported. Note that to target the default (dot) shape you don't need to specify a shape. + +| Spoken form | Shape | Internal ID | Enabled by default? | +| ----------- | ------------------------------------------------------------------ | ------------ | ------------------- | +| N/A | ![Default](../../../../../resources/images/hats/default.svg) | `default` | ✅ | +| `"bolt"` | ![Bolt](../../../../../resources/images/hats/bolt.svg) | `bolt` | ❌ | +| `"curve"` | ![Curve](../../../../../resources/images/hats/curve.svg) | `curve` | ❌ | +| `"fox"` | ![Fox](../../../../../resources/images/hats/fox.svg) | `fox` | ❌ | +| `"frame"` | ![Frame](../../../../../resources/images/hats/frame.svg) | `frame` | ❌ | +| `"play"` | ![Play](../../../../../resources/images/hats/play.svg) | `play` | ❌ | +| `"wing"` | ![Wing](../../../../../resources/images/hats/wing.svg) | `wing` | ❌ | +| `"hole"` | ![Hole](../../../../../resources/images/hats/hole.svg) | `hole` | ❌ | +| `"ex"` | ![Ex](../../../../../resources/images/hats/ex.svg) | `ex` | ❌ | +| `"cross"` | ![Crosshairs](../../../../../resources/images/hats/crosshairs.svg) | `crosshairs` | ❌ | +| `"eye"` | ![Eye](../../../../../resources/images/hats/eye.svg) | `eye` | ❌ | + +You can enable or disable shapes in your VSCode settings, by searching for [`cursorless.hatEnablement.shapes`](vscode://settings/cursorless.hatEnablement.shapes) and checking the box next to the internal ID for the given shape as listed above. To navigate to your VSCode settings, either say "show settings", or go to File --> Preferences --> Settings. + +If you find these shape names unintuitive / tough to remember, their +spoken forms can be [customized](./customization.md) like any other spoken form +in cursorless. If you change a spoken form to be more than one syllable, you +can change the penalty in the [`cursorless.hatPenalties.shapes`](vscode://settings/cursorless.hatPenalties.shapes) setting to the +number of syllables you use, so that cursorless can optimize hat allocation to +minimize syllables. + +#### `"this"` + +The word `"this"` can be used as a mark to refer to the current cursor(s) or selection(s) as a target. Note that when combined with a modifier, the `"this"` mark can be omitted, and it will be implied. + +- `"chuck this"` +- `"take funk this"` +- `"pre funk"` +- `"chuck line"` + +Note that if you say `"this"` with an empty selection, it refers to the token containing your cursor. + +#### `"that"` + +The word `"that"` can be used as a mark to refer to the target of the previous cursorless command. + +- `"pre that"` +- `"round wrap that"` + +#### `"row "` + +The word `"row"` followed by a number can be used to refer to a line by its line number. Note that the line numbers are modulo 100, meaning that you only say the last two digits of the line number. Also note that the line must be visible within the viewport. + +- `"chuck row twenty four"` +- `"post row eighty nine"` +- `"pour row eleven"` + +#### `"up "` / `"down "` + +The word `"up"` or `"down"` followed by a number can be used to refer to the line that is `` lines above or below the cursor. The line may be outside of the viewport. In the case of multiple selections, this mark only refers to the line relative to the primary selection. You can turn on relative line numbers in the VSCode settings to make these marks easier to use. + +- `"copy up one"` +- `"comment down two"` + +### Modifiers + +Modifiers change a target's extent or interpretation. See the [modifier reference](./modifiers/README.md) for the available modifiers and their detailed behavior. + +Scopes expand a target to a containing text or syntax-tree structure. See the [scope reference](./scopes/README.md) for the available scopes, and use the [scope visualizer](./scope-visualizer.md) to explore the scopes supported in your code. + +## Compound targets + +Individual targets can be combined into compound targets to make bigger targets or refer to multiple selections at the same time. + +### Range targets + +A range target uses one primitive target as its start and another as its end to form a range from the start to the end. For example, `"air past bat"` refers to the range from the token with a hat over its 'a' to a token with a hat over its 'b'. + +Note that if the first target is omitted, the start of the range will be the current selection(s). + +- `"take [blue] air past [green] bat"` +- `"take past [blue] air"` +- `"take funk [blue] air past [blue] bat"` (note end of range inherits `"funk"`) +- `"take funk [blue] air past token [blue] bat"` +- `"take past end of line"` +- `"take past start of line"` +- `"take [blue] air past end of line"` + +eg: +`take blue air past green bat` +Selects the range from the token containing letter 'a' with a blue hat past the token containing letter 'b' with a green hat. + +#### Vertical ranges + +The `"slice"` range modifier is used to refer to multiple targets that are vertically aligned. It is commonly used with the `"pre"` action to add multiple cursors to the editor. Each cursor is inserted at the same column on each row requested within the command. + +- `"pre slice past "`: Add cursors from the first target through to the second target's line(inclusive end) +- `"pre slice "`: Shortened version of above `"slice past"` command +- `"pre slice until "`: Add cursors until the second target's line(non-inclusive end) +- `"pre slice between "`: Add cursors between first and second target's lines(non-inclusive start and end) + +For example: + +- `"pre air slice bat"`: Places cursors at the same position on every line (inclusive) between token with hat over the `a` and token with the hat over the `b`. The position will be the start of the token with a hat over the `a` +- `"chuck tail air slice end of block"`: Delete the end of every line from air through the end of its non-empty line block. + +#### `"every"` ranges + +If the range target begins with `"every "`, eg `"take every line air past bat"`, then you will end up with one target for each instance of `` in the range. For example, `"post every line air past bat"` will put a cursor at the end of every line from the line containing the token with a hat over the letter `a` to the line containing the token with a hat over the letter `b`. + +These `"every"` ranges also play nicely with exclusive ranges, eg `"take every funk air until bat"` will select every function starting from the function containing the token with a hat over the letter `a` up until, but not including, the function containing the token with a hat over the letter `b`. + +### List targets + +In addition to range targets, cursorless supports list targets, which allow you to refer to multiple targets at the same time. When combined with the `"take"` action, this will result in multiple cursors, for other actions, such as `"chuck"` the action will be applied to all the different targets at once. + +- `"take [blue] air and [green] bat"` +- `"take funk [blue] air and [green] bat"` (note second target inherits `"funk"`) +- `"take funk [blue] air and token [green] bat"` +- `"take air and bat past cap"` + +eg: +`take blue air and green bat` +Selects both the token containing letter 'a' with a blue hat AND the token containing 'b' with a green hat. diff --git a/packages/app-web-docs/src/docs/user/visual-accessibility.md b/packages/app-web-docs/src/docs/user/visual-accessibility.md index ceb26ca76f4..c9232c33433 100644 --- a/packages/app-web-docs/src/docs/user/visual-accessibility.md +++ b/packages/app-web-docs/src/docs/user/visual-accessibility.md @@ -1,6 +1,6 @@ # Visual Accessibility -Cursorless has multiple settings that can be customized to improve accessibility for users with color blindness or other vision impairments. The primary visual elements of Cursorless are the [hats](./README.md#decorated-symbol), so this guide will focus on customizing the hats. +Cursorless has multiple settings that can be customized to improve accessibility for users with color blindness or other vision impairments. The primary visual elements of Cursorless are the [hats](./targets.md#decorated-symbol), so this guide will focus on customizing the hats. ## Make the hats bigger diff --git a/packages/lib-cheatsheet/src/lib/utils/cheatsheetLegendData.tsx b/packages/lib-cheatsheet/src/lib/utils/cheatsheetLegendData.tsx index a8b58a0ce56..0371712eb7c 100644 --- a/packages/lib-cheatsheet/src/lib/utils/cheatsheetLegendData.tsx +++ b/packages/lib-cheatsheet/src/lib/utils/cheatsheetLegendData.tsx @@ -23,7 +23,7 @@ export const cheatsheetLegendData: CheatsheetLegend = [ { term: "target", definition: "Cursorless target", - link: "https://www.cursorless.org/docs/#targets", + link: "https://www.cursorless.org/docs/user/targets", id: "target", }, {