Skip to content

Workspace trust: improve docs#15531

Closed
xe-nul wants to merge 1 commit into
helix-editor:masterfrom
xe-nul:push-yqwvxnszqsnn
Closed

Workspace trust: improve docs#15531
xe-nul wants to merge 1 commit into
helix-editor:masterfrom
xe-nul:push-yqwvxnszqsnn

Conversation

@xe-nul

@xe-nul xe-nul commented Mar 27, 2026

Copy link
Copy Markdown
Contributor

When I wrote docs for the original PR, I tried to make them as comprehensive as possible. They weren't much comprehensible as a result.

Here, for clarity sake, I tried to remove things that probably shouldn't be explained in the first place.

Helix will not trust any workspace by default.

If you decide not to trust a workspace and don't want to be prompted about trust every time you start a new session in it, you can exclude the workspace by choosing `Never` option in trust selection window.
When you open a file in an untrusted workspace, you will be prompted about trust. You can make a choice with arrow keys, `<Tab>`, `<C-n>` and `<C-p>`, confirming selection with `<Enter>`. Typing anything else will close the menu selecting 'Not now' option.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is probably more words than we really need, but what I am trying to say here is: you can make the menu go away by pressing pretty much any button except those that do something in the menu.

I think that's really important to understand, so that the thing doesn't get in the way. On the second thought, it should get pretty apparent when you actually use the thing yourself, so it might not need an explanation.

<!-- TODO: Windows paths -->
Lists of trusted and excluded workspaces, delimited by newline characters, are stored in:
- Linux and macOS: `~/.local/share/helix/trusted_workspaces` and `~/.local/share/helix/excluded_workspaces`
- Windows: `%AppData%/Roaming/helix/trusted_workspaces` and `%AppData%/Roaming/helix/excluded_workspaces`

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Windows path is taken from etcetera's crate code. If I'm holding that code right, this is where it should be stored, but I hope someone with Windows box comes around and tells for sure.

@xe-nul

xe-nul commented Apr 14, 2026

Copy link
Copy Markdown
Contributor Author

Closed in favor of #15636

@xe-nul xe-nul closed this Apr 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant