diff --git a/extension/package.json b/extension/package.json
index a313e6d8bd..7ad2bd4201 100644
--- a/extension/package.json
+++ b/extension/package.json
@@ -1341,115 +1341,111 @@
"walkthroughs": [
{
"id": "welcome",
- "title": "Get Started with DVC",
- "description": "Your first steps to set up a DVC project with all the powerful tools and features that the DVC extension has to offer!",
+ "title": "Get Started",
+ "description": "Your first steps to build better models faster with experiment tracking and dataset versioning",
"steps": [
{
"id": "dvc.installDVC",
"title": "Install DVC",
- "description": "The DVC extension requires DVC to be installed. To install follow the guide shown on [dvc.org](https://dvc.org).\n\n[Install DVC](https://dvc.org/doc/install)\n",
+ "description": "This extension requires DVC to be installed. To install follow the guide shown on [dvc.org](https://dvc.org).\n\n[Install DVC](https://dvc.org/doc/install)\n",
"media": {
"markdown": "resources/walkthrough/install-dvc.md"
},
"completionEvents": [
"onLink:https://dvc.org",
- "onLink:https://dvc.org/doc/install"
+ "onLink:https://dvc.org/doc/install",
+ "onCommand:dvc.setupWorkspace"
]
},
{
- "id": "dvc.setup",
- "title": "Setup The Workspace",
- "description": "Setup the workspace for the DVC extension.\n[Setup The Workspace](command:dvc.setupWorkspace)",
+ "id": "dvc.setupProject",
+ "title": "Setup Project",
+ "description": "Try an example project and setup DVC to start tracking datasets, models, metrics, and plots\n\n[Example Project](https://github.com/iterative/example-get-started)\n",
"media": {
- "markdown": "resources/walkthrough/setup-workspace.md"
+ "markdown": "resources/walkthrough/setup-project.md"
},
"completionEvents": [
- "onCommand:dvc.setupWorkspace"
+ "onLink:https://github.com/iterative/example-get-started",
+ "onLink:https://github.com/iterative/vscode-dvc/tree/main/demo",
+ "onLink:https://dvc.org/doc/dvclive"
]
},
{
"id": "dvc.showCommands",
"title": "Available Commands",
- "description": "View available commands.\n[View Commands](command:dvc.showCommands)",
+ "description": "See all available commands.\n[View Commands](command:dvc.showCommands)",
"media": {
"markdown": "resources/walkthrough/command-palette.md"
},
"completionEvents": [
"onCommand:dvc.showCommands"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ ]
},
{
- "id": "dvc.showOutput",
- "title": "Output Channel",
- "description": "View the DVC output channel.\n[View Output](command:dvc.showOutput)",
+ "id": "dvc.viewContainer",
+ "title": "Control from the Side Bar",
+ "description": "Use rich views to quickly access, control, or overview your experiments and plots.\n[Show Views](command:workbench.view.extension.dvc-views)",
"media": {
- "markdown": "resources/walkthrough/output-channel.md"
+ "markdown": "resources/walkthrough/view-container.md"
},
"completionEvents": [
- "onCommand:dvc.showOutput"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ "onCommand:workbench.view.extension.dvc-views"
+ ]
},
{
- "id": "dvc.scm",
- "title": "Source Control Management",
- "description": "Open the SCM view.\n[Show SCM](command:workbench.view.scm)",
+ "id": "dvc.experimentsTable",
+ "title": "Experiments Table",
+ "description": "Displays your experiments in a customizable table.\n[Show Table](command:dvc.showExperiments)",
"media": {
- "markdown": "resources/walkthrough/source-control-management.md"
+ "markdown": "resources/walkthrough/experiments-table.md"
},
"completionEvents": [
- "onCommand:workbench.view.scm"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ "onCommand:dvc.showExperiments"
+ ]
},
{
- "id": "dvc.tracked",
- "title": "Tracked Resources",
- "description": "Open the DVC tracked view.\n[Show Tracked](command:dvc.views.trackedExplorerTree.focus)",
+ "id": "dvc.runExperiments",
+ "title": "Running Experiments",
+ "description": "Explore a few ways you can run or queue a new experiment.\n[Run an Experiment](command:dvc.modifyExperimentParamsAndRun)",
"media": {
- "markdown": "resources/walkthrough/tracked-explorer.md"
+ "markdown": "resources/walkthrough/run-experiments.md"
},
"completionEvents": [
- "onCommand:dvc.views.trackedExplorerTree.focus"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ "onCommand:dvc.modifyExperimentParamsAndRun"
+ ]
},
{
- "id": "dvc.viewContainer",
- "title": "DVC View Container",
- "description": "Open the DVC view container.\n[Show Views](command:workbench.view.extension.dvc-views)",
+ "id": "dvc.plots",
+ "title": "Plots",
+ "description": "Visualize and compare multiple experiments with interactive customizable charts.\n[Show Plots](command:dvc.showPlots)",
"media": {
- "markdown": "resources/walkthrough/view-container.md"
+ "markdown": "resources/walkthrough/plots.md"
},
"completionEvents": [
- "onCommand:workbench.view.extension.dvc-views"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ "onCommand:dvc.showPlots"
+ ]
},
{
- "id": "dvc.experimentsTable",
- "title": "Experiments Table",
- "description": "Open the experiments table.\n[Show Table](command:dvc.showExperiments)",
+ "id": "dvc.tracked",
+ "title": "Tracked Resources",
+ "description": "Open the DVC tracked view.\n[Show Tracked](command:dvc.views.trackedExplorerTree.focus)",
"media": {
- "markdown": "resources/walkthrough/experiments-table.md"
+ "markdown": "resources/walkthrough/tracked-explorer.md"
},
"completionEvents": [
- "onCommand:dvc.showExperiments"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ "onCommand:dvc.views.trackedExplorerTree.focus"
+ ]
},
{
- "id": "dvc.plots",
- "title": "Plots",
- "description": "Open plots.\n[Show Plots](command:dvc.showPlots)",
+ "id": "dvc.scm",
+ "title": "Source Control Management",
+ "description": "Open the SCM view.\n[Show SCM](command:workbench.view.scm)",
"media": {
- "markdown": "resources/walkthrough/plots.md"
+ "markdown": "resources/walkthrough/source-control-management.md"
},
"completionEvents": [
- "onCommand:dvc.showPlots"
- ],
- "when": "dvc.commands.available && dvc.project.available"
+ "onCommand:workbench.view.scm"
+ ]
},
{
"id": "dvc.learnMore",
@@ -1461,6 +1457,17 @@
"completionEvents": [
"onLink:https://dvc.org/doc"
]
+ },
+ {
+ "id": "dvc.troubleshoot",
+ "title": "Troubleshoot",
+ "description": "View the DVC output channel.\n[View Output](command:dvc.showOutput)",
+ "media": {
+ "markdown": "resources/walkthrough/troubleshoot.md"
+ },
+ "completionEvents": [
+ "onCommand:dvc.showOutput"
+ ]
}
]
}
diff --git a/extension/resources/walkthrough/command-palette.md b/extension/resources/walkthrough/command-palette.md
index d8b030accb..9736e3c3da 100644
--- a/extension/resources/walkthrough/command-palette.md
+++ b/extension/resources/walkthrough/command-palette.md
@@ -7,5 +7,10 @@ Which can be accessed via `F1` or ⇧⌃P on Windows/Linux or ⇧⌘P on macOS.
To see a list of available commands click [here](command:dvc.showCommands) or
type DVC into the Command Palette.
+
+ 
+
+
For further information on `DVC` commands see the
[command-reference docs](https://dvc.org/doc/command-reference).
diff --git a/extension/resources/walkthrough/dvc-learn-more.md b/extension/resources/walkthrough/dvc-learn-more.md
index c18db9bb20..0edcb8ab94 100644
--- a/extension/resources/walkthrough/dvc-learn-more.md
+++ b/extension/resources/walkthrough/dvc-learn-more.md
@@ -8,7 +8,7 @@
- View all [available commands](https://dvc.org/doc/command-reference).
-- Check out the [DVC github repository](https://github.com/iterative/dvc) or an
+- Check out the [DVC GitHub repository](https://github.com/iterative/dvc) or an
[example project](https://github.com/iterative/example-get-started).
- Explore our [free course](https://learn.iterative.ai/).
diff --git a/extension/resources/walkthrough/experiments-table.md b/extension/resources/walkthrough/experiments-table.md
index 68c20416ff..a28fe3e4a8 100644
--- a/extension/resources/walkthrough/experiments-table.md
+++ b/extension/resources/walkthrough/experiments-table.md
@@ -1,9 +1,32 @@
# Experiments Table
-The extension's equivalent of `dvc exp show`.
+> ❗ DVC should be installed and DVC project available in the workspace for this
+> and the next steps to work properly. Please refer to first two steps of this
+> guide.
-Use `DVC: Show Experiments` from the Command Palette to open up the experiments
-table for a `DVC` repository.
+As you change code, parameters, data and run new experiments this table will
+keep all the details about your iterations. It can be manipulated and configured
+using the [DVC side panel](command:workbench.view.extension.dvc-views). This is
+the extension's equivalent of the `dvc exp show` command.
-The view can be manipulated using the controls shown in the extension's view
-container.
+
+ 
+
+
+Use `DVC: Show Experiments` from the
+[Command Palette](command:workbench.action.quickOpen?%22>DVC:%20Show%20Experiments%22)
+to open up the experiments table or access it, using the Columns view:
+
+
+ 
+
+
+Table provides context menus to access basic operation on experiments and table
+headers. You can edit parameters, apply sort or filter, run new experiments and
+more:
+
+
+ 
+
diff --git a/extension/resources/walkthrough/images/available-commands-command-palette.png b/extension/resources/walkthrough/images/available-commands-command-palette.png
new file mode 100644
index 0000000000..0deb9d3059
Binary files /dev/null and b/extension/resources/walkthrough/images/available-commands-command-palette.png differ
diff --git a/extension/resources/walkthrough/images/experiments-table-context-menus.png b/extension/resources/walkthrough/images/experiments-table-context-menus.png
new file mode 100644
index 0000000000..1b056ff054
Binary files /dev/null and b/extension/resources/walkthrough/images/experiments-table-context-menus.png differ
diff --git a/extension/resources/walkthrough/images/experiments-table-from-side-bar.png b/extension/resources/walkthrough/images/experiments-table-from-side-bar.png
new file mode 100644
index 0000000000..ae3e601981
Binary files /dev/null and b/extension/resources/walkthrough/images/experiments-table-from-side-bar.png differ
diff --git a/extension/resources/walkthrough/images/experiments-table.png b/extension/resources/walkthrough/images/experiments-table.png
new file mode 100644
index 0000000000..b7d5daf344
Binary files /dev/null and b/extension/resources/walkthrough/images/experiments-table.png differ
diff --git a/extension/resources/walkthrough/images/install-dvc-setup-wizard.png b/extension/resources/walkthrough/images/install-dvc-setup-wizard.png
new file mode 100644
index 0000000000..7c22a0f4ec
Binary files /dev/null and b/extension/resources/walkthrough/images/install-dvc-setup-wizard.png differ
diff --git a/extension/resources/walkthrough/images/install-dvc-status-bar-detected.png b/extension/resources/walkthrough/images/install-dvc-status-bar-detected.png
new file mode 100644
index 0000000000..17c3281b09
Binary files /dev/null and b/extension/resources/walkthrough/images/install-dvc-status-bar-detected.png differ
diff --git a/extension/resources/walkthrough/images/plots-data-series.png b/extension/resources/walkthrough/images/plots-data-series.png
new file mode 100644
index 0000000000..cc051cca44
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-data-series.png differ
diff --git a/extension/resources/walkthrough/images/plots-dump-image.png b/extension/resources/walkthrough/images/plots-dump-image.png
new file mode 100644
index 0000000000..9c0679a233
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-dump-image.png differ
diff --git a/extension/resources/walkthrough/images/plots-dump-with-dvclive.png b/extension/resources/walkthrough/images/plots-dump-with-dvclive.png
new file mode 100644
index 0000000000..d3b6e7feab
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-dump-with-dvclive.png differ
diff --git a/extension/resources/walkthrough/images/plots-dump-with-open-file.png b/extension/resources/walkthrough/images/plots-dump-with-open-file.png
new file mode 100644
index 0000000000..35551e215a
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-dump-with-open-file.png differ
diff --git a/extension/resources/walkthrough/images/plots-experiments-view-icon.png b/extension/resources/walkthrough/images/plots-experiments-view-icon.png
new file mode 100644
index 0000000000..f65db32b92
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-experiments-view-icon.png differ
diff --git a/extension/resources/walkthrough/images/plots-images.png b/extension/resources/walkthrough/images/plots-images.png
new file mode 100644
index 0000000000..5f9e31e187
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-images.png differ
diff --git a/extension/resources/walkthrough/images/plots-plots-view-icon.png b/extension/resources/walkthrough/images/plots-plots-view-icon.png
new file mode 100644
index 0000000000..ad323d431f
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-plots-view-icon.png differ
diff --git a/extension/resources/walkthrough/images/plots-trends.png b/extension/resources/walkthrough/images/plots-trends.png
new file mode 100644
index 0000000000..2f7a5d334a
Binary files /dev/null and b/extension/resources/walkthrough/images/plots-trends.png differ
diff --git a/extension/resources/walkthrough/images/run-experiments-command-palette.png b/extension/resources/walkthrough/images/run-experiments-command-palette.png
new file mode 100644
index 0000000000..839fa7d2c2
Binary files /dev/null and b/extension/resources/walkthrough/images/run-experiments-command-palette.png differ
diff --git a/extension/resources/walkthrough/images/run-experiments-params-buttons.png b/extension/resources/walkthrough/images/run-experiments-params-buttons.png
new file mode 100644
index 0000000000..7e30869b84
Binary files /dev/null and b/extension/resources/walkthrough/images/run-experiments-params-buttons.png differ
diff --git a/extension/resources/walkthrough/images/run-experiments-table-buttons.png b/extension/resources/walkthrough/images/run-experiments-table-buttons.png
new file mode 100644
index 0000000000..c9e12ce610
Binary files /dev/null and b/extension/resources/walkthrough/images/run-experiments-table-buttons.png differ
diff --git a/extension/resources/walkthrough/images/setup-project-dump-metrics.png b/extension/resources/walkthrough/images/setup-project-dump-metrics.png
new file mode 100644
index 0000000000..3cb7b6db75
Binary files /dev/null and b/extension/resources/walkthrough/images/setup-project-dump-metrics.png differ
diff --git a/extension/resources/walkthrough/images/setup-project-dvc-yaml-example.png b/extension/resources/walkthrough/images/setup-project-dvc-yaml-example.png
new file mode 100644
index 0000000000..dd23d0cf24
Binary files /dev/null and b/extension/resources/walkthrough/images/setup-project-dvc-yaml-example.png differ
diff --git a/extension/resources/walkthrough/images/setup-project-dvclive-metrics.png b/extension/resources/walkthrough/images/setup-project-dvclive-metrics.png
new file mode 100644
index 0000000000..9f596a4041
Binary files /dev/null and b/extension/resources/walkthrough/images/setup-project-dvclive-metrics.png differ
diff --git a/extension/resources/walkthrough/images/view-container-columns.png b/extension/resources/walkthrough/images/view-container-columns.png
new file mode 100644
index 0000000000..9589affbac
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-columns.png differ
diff --git a/extension/resources/walkthrough/images/view-container-experiments.png b/extension/resources/walkthrough/images/view-container-experiments.png
new file mode 100644
index 0000000000..0afe07c902
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-experiments.png differ
diff --git a/extension/resources/walkthrough/images/view-container-filter.png b/extension/resources/walkthrough/images/view-container-filter.png
new file mode 100644
index 0000000000..60007f1f7f
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-filter.png differ
diff --git a/extension/resources/walkthrough/images/view-container-plots.png b/extension/resources/walkthrough/images/view-container-plots.png
new file mode 100644
index 0000000000..2dd943d54e
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-plots.png differ
diff --git a/extension/resources/walkthrough/images/view-container-show.png b/extension/resources/walkthrough/images/view-container-show.png
new file mode 100644
index 0000000000..70c0544fcc
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-show.png differ
diff --git a/extension/resources/walkthrough/images/view-container-sort.png b/extension/resources/walkthrough/images/view-container-sort.png
new file mode 100644
index 0000000000..2ad757c123
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-sort.png differ
diff --git a/extension/resources/walkthrough/images/view-container-support.png b/extension/resources/walkthrough/images/view-container-support.png
new file mode 100644
index 0000000000..9758f9ec73
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-support.png differ
diff --git a/extension/resources/walkthrough/images/view-container-welcome.png b/extension/resources/walkthrough/images/view-container-welcome.png
new file mode 100644
index 0000000000..edb2d0053a
Binary files /dev/null and b/extension/resources/walkthrough/images/view-container-welcome.png differ
diff --git a/extension/resources/walkthrough/install-dvc.md b/extension/resources/walkthrough/install-dvc.md
index aca0c65a6c..770532f99f 100644
--- a/extension/resources/walkthrough/install-dvc.md
+++ b/extension/resources/walkthrough/install-dvc.md
@@ -1,13 +1,24 @@
# Install DVC
-There are quite a few options for installing `DVC`. This extension supports
-various installation types. See the `Setup The Workspace` step for more details.
+There are a few [options](https://dvc.org/doc/install) for installing `DVC`.
+This extension supports all installation types.
-To install the latest version of `DVC` follow your platform specific guide on
-[dvc.org](https://dvc.org/doc/install).
+To verify the installation run `dvc -h` in a
+[Terminal](command:workbench.action.terminal.new).
-To verify the installation run `dvc -h` in your terminal of choice.
+If DVC is installed as a global binary or in a Python virtual environment, the
+extension should detect it automatically and you should see a DVC icon like this
+in the status bar:
-**Note**: Use `Terminal: Create New Terminal` from the Command Palette to create
-a new
-[integrated terminal](https://code.visualstudio.com/docs/editor/integrated-terminal).
+
+ 
+
+
+If you see instead the crossed circle icon, use the
+[Setup Workspace](command:dvc.setupWorkspace) wizard to manually select the
+right environment:
+
+
+ 
+
diff --git a/extension/resources/walkthrough/plots.md b/extension/resources/walkthrough/plots.md
index 6f1bb43690..35d7bd0011 100644
--- a/extension/resources/walkthrough/plots.md
+++ b/extension/resources/walkthrough/plots.md
@@ -1,14 +1,61 @@
# Plots
-The extension will display the following sections for selected experiments:
+Select one or more experiments to visualize them in the
+[`Plots View`](command:onCommand:dvc.showPlots). This is the extension's
+equivalent of the `dvc plots show` and `dvc plots diff` commands.
-- Data Series - JSON, YAML, CSV or TSV files visualized using Vega pre-defined
- or custom Vega-Lite templates.
-- Images - a table used to display image plots side by side.
-- Trends - linear plots based on data from the experiments table.
+💡 If you don't have any DVC
+[plots](https://dvc.org/doc/command-reference/plots) in the project, start
+writing data points into JSON, YAML, CSV or TSV or saving plots as images
+(`.png`, etc) (check the [DVCLive](https://dvc.org/doc/dvclive) helper library
+if you use Python):
-Use `DVC: Show Plots` from the Command Palette to open the view for a `DVC`
-repository.
+
+ 
+ 
+ 
+
-The view can be manipulated using the controls shown in the extension's view
-container.
+Use `DVC: Show Plots` from the
+[Command Palette](command:workbench.action.quickOpen?%22>DVC:%20Show%20Plots%22)
+to open up the plots dashboard. The extension will display the following
+sections for selected experiments, that correspond to the different
+[types of plots](https://dvc.org/doc/command-reference/plots#supported-file-formats)
+supported by DVC:
+
+
+ 
+
+
+`Data Series`. JSON, YAML, CSV or TSV files visualized using the predefined
+(e.g. confusion matrix, linear) or custom (Vega-lite) templates:
+
+
+ 
+
+
+`Images`. Any image file (e,g `.png`) can be visualized as a plot. They will be
+rendered side by side in the table:
+
+
+ 
+
+
+`Trends`. Linear plots based on data from the experiments table if you use
+[checkpoints](https://dvc.org/doc/user-guide/experiment-management/checkpoints):
+
+The plots dashboard can be configured and accessed using using the `Plots` and
+`Experiments` views:
+
+
+ 
+ 
+
diff --git a/extension/resources/walkthrough/run-experiments.md b/extension/resources/walkthrough/run-experiments.md
new file mode 100644
index 0000000000..5739f90772
--- /dev/null
+++ b/extension/resources/walkthrough/run-experiments.md
@@ -0,0 +1,31 @@
+# Running Experiments
+
+You edit your code, edit or add more data, applying a new combination of
+hyperparameters- you have a new idea to try 💡!
+
+This extension provides many different ways to run a new experiment or queue it
+to be run later in the background or in parallel. This functionality wraps up
+the [`dvc exp run`](https://dvc.org/doc/command-reference/exp/run) command.
+
+The basic one is the set of buttons that are availble when the experiments table
+or parameters file are open:
+
+
+ 
+ 
+
+
+After you are done modifying the project you can hit `Run`, `Queue`, and
+`Run all`. As you do this you should see new items in the experiments table.
+
+As usual, you can do the same and more with the context menus in the experiments
+table, in the experiments View in the side bar, or via the command palette. For
+example, we can take one of the existing experiments as a base, modify some
+parameters and run/queue a new iteration:
+
+
+ 
+
diff --git a/extension/resources/walkthrough/setup-project.md b/extension/resources/walkthrough/setup-project.md
new file mode 100644
index 0000000000..a82706ca49
--- /dev/null
+++ b/extension/resources/walkthrough/setup-project.md
@@ -0,0 +1,38 @@
+# Setup DVC Project
+
+> Skip this step if you already have a DVC project with metrics, plots, and
+> params.
+
+💡 Check the [Get Started](https://github.com/iterative/example-get-started) and
+[Extension Demo](https://github.com/iterative/vscode-dvc/tree/main/demo)
+projects to quickly try the extension.
+
+To setup the project run
+[`dvc exp init`](https://dvc.org/doc/command-reference/exp/init#example-interactive-mode)
+in a [Terminal](command:workbench.action.terminal.new).
+
+It will generate a config file `dvc.yaml` that describes the project, and can
+look like this:
+
+
+ 
+
+
+💡 Names, values in this file are project dependent and can customized.
+
+DVC and this extension read experiments data from these files (`metrics.json`,
+`params.yaml`, etc). You need to instrument your code to start writing / reading
+them (example is in Python, but it can be done in any language):
+
+
+ 
+
+
+Or alternatively using the [`DVCLive`](https://dvc.org/doc/dvclive) Python
+library that can read / write a lot of different common metrics and plots:
+
+
+ 
+
diff --git a/extension/resources/walkthrough/setup-workspace.md b/extension/resources/walkthrough/setup-workspace.md
deleted file mode 100644
index ddcf02d175..0000000000
--- a/extension/resources/walkthrough/setup-workspace.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Integrating with the CLI
-
-This extension can support a global or virtual environment installation of
-`DVC`.
-
-You will need a `DVC` project opened within the workspace to see all of the
-extension's available features. See the `Explore More Resources` step for
-details on creating a `DVC` project.
-
-Use the workspace setup wizard to set the required config options.
-
-Once completed, the rest of the walkthrough will appear.
-
-The wizard can be accessed by clicking [here](command:dvc.setupWorkspace) or use
-`DVC: Setup The Workspace` from the Command Palette.
diff --git a/extension/resources/walkthrough/output-channel.md b/extension/resources/walkthrough/troubleshoot.md
similarity index 100%
rename from extension/resources/walkthrough/output-channel.md
rename to extension/resources/walkthrough/troubleshoot.md
diff --git a/extension/resources/walkthrough/view-container.md b/extension/resources/walkthrough/view-container.md
index 89e6a1b0a7..2c35576c51 100644
--- a/extension/resources/walkthrough/view-container.md
+++ b/extension/resources/walkthrough/view-container.md
@@ -1,14 +1,57 @@
-# DVC View Container
-
-The view container provides supplementary information and control over the
-experiments and plots in the workspace.
+# DVC Views
Click on the `DVC` icon in the
[Activity Bar](https://code.visualstudio.com/docs/getstarted/userinterface) to
-access the container or use
+access the views or use
[View: Show DVC](command:workbench.view.extension.dvc-views) from the Command
Palette.
-A welcome view showing some getting started instructions will appear in the
-container when the CLI is not accessible or if there is not a `DVC` project
-available in the workspace.
+❗ A welcome and support views showing some getting started instructions will
+appear in the container when the `DVC` is not installed or if there is not a
+`DVC` project available in the workspace:
+
+
+ 
+ 
+
+
+> 🤗 If something goes wrong, you have a feature request, you need some help-
+> don't hesitate to ping us in the [Discord](https://discord.gg/BGCjJHvDHt)
+> channel or open and issue on
+> [GitHub](https://github.com/iterative/vscode-dvc/issues). We are happy to
+> help.
+
+If DVC and the extension are initialized, side bar exposes multiple views:
+
+
+ 
+ 
+
+
+ 
+ 
+
+
+ 
+ 
+
+
+- `COLUMNS`. It is used to fine tune the experiments table header to focus on
+ the most important metrics, parameters, and data signals and to view all
+ available columns.
+- `EXPERIMENTS`. It exposes the list of experiment, their checkpoints and common
+ actions with them.
+- `SORT BY`. It is used to configure and see how the experiments table is
+ sorted.
+- `FILTER BY`. It is used to view, add, or remove filters by metrics and params
+ to find or hide specific experiments in the experiments table.
+- `PLOTS`. It can be used to fine tune the plots panel, to toggle on or off
+ specific plots, and view all available plots.