vscode-zig: command 'zig.zls.startRestart' not found

I think the main problem is documentation.

It’s unclear from the docs or setup that these settings need to be set:

* zig.initialSetupDone

* zig.path

* zig.zls.path

I agree, which is why I created #142. Unfortunately, this was closed without any documentation being added. I would have been happy to open a pr to address this if I thought the maintainers would be receptive to it.

I think the maintainers have a philosophy about software development that UX alone should be good enough to make documentation unnecessary. I agree that this is a good goal that we should all pursue. But it is not realistic to assume that it can always be reached 100%, especially when the software is just a plugin with UX that is tightly constrained by another application.

I occasionally set up new vscode instances with this extension and in my experience, these settings often do not get configured. I dealt with this as recently as last week. There are supposed to be prompts to ensure these are configured, but I don’t think this approach is very reliable.

I already know that they need to be set, so I manually go into the config file and edit the values when necessary. For new users who don’t have this knowledge yet, it could be useful to have a simple explanation to help them troubleshoot when these values are not set correctly, so they don’t need to go through github issues to figure it out. It would also be useful for anyone who needs to make changes to their zig tooling after the initial setup of this extension.

A new version of the extension has been published, please try running through the setup with it.

I have zig installed I have zls installed I have the zig language extension installed.

Documentation says everything should work out of the box but it does not. Either documentation with the correct steps need to be written, or there is a bug.