Make Workspace feature Understandable For People Switching To VSCode

[vscode-pmaher]

For people new to VSCode the workspace feature is completely confusing and needs reviewing. I'm sure it makes perfect sense to VSCode devs and probably for people who've been using VSCode for years. However, I've read all the documentation on workspaces and it actually made me even more confused about the feature.

What the hell is a multi-root workspace and what is it for, what's a real-world example of usage?

Is a workspace a project or something different?

What should be the location of the workspace file in relation to a projects root folder?

If I have multiple projects, each with its own project root folder and I only don't want the multi-root workspace (what ever the hell that is).... i.e. I work on one project at a time, what is a workflow/project setup example with workspaces explained in plain language please?

[gregvanl]

Closing old issue. Workspace is usually just the project folder. Multi-root workspaces is an advanced configuration.