From b97b892e4290b8bfa576b4c7f2b7777d24d8d341 Mon Sep 17 00:00:00 2001
From: pollfly <75068813+pollfly@users.noreply.github.com>
Date: Thu, 1 Jun 2023 13:07:36 +0300
Subject: [PATCH] Edit comparing Dataviews page (#579)

---
 .../webapp/webapp_exp_comparing.md            | 32 ++++++++-----------
 1 file changed, 13 insertions(+), 19 deletions(-)

diff --git a/docs/hyperdatasets/webapp/webapp_exp_comparing.md b/docs/hyperdatasets/webapp/webapp_exp_comparing.md
index 82afde11..cf4bef36 100644
--- a/docs/hyperdatasets/webapp/webapp_exp_comparing.md
+++ b/docs/hyperdatasets/webapp/webapp_exp_comparing.md
@@ -3,7 +3,7 @@ title: Comparing Dataviews
 ---
 
 In addition to [ClearML's comparison features](../../webapp/webapp_exp_comparing.md), the ClearML Enterprise WebApp 
-supports comparing input data selection criteria of experiment Dataviews, enabling to easily locate, visualize, and analyze differences.
+supports comparing input data selection criteria of experiment [Dataviews](../dataviews.md), enabling to easily locate, visualize, and analyze differences.
 
 ## Selecting Experiments 
 
@@ -12,27 +12,21 @@ To select experiments to compare:
 1. Select the experiments to compare. Once multiple experiments are selected, the batch action bar appears.
 1. In the batch action bar, click **COMPARE**. 
 
-The comparison page opens in the **DETAILS** tab, showing a column for each experiment. The experiment on the left is 
-used as the base experiment, to which the other experiments are compared. 
+The comparison page opens in the **DETAILS** tab, showing a column for each experiment. 
 
-## Dataviews (Input Data)
+## Dataviews
 
-**To locate the input data differences:**
+In the **Details** tab, you can view differences in the experiments’ nominal values. Each experiment’s information is 
+displayed in a column, so each field is lined up side-by-side. Expand the **DATAVIEWS** 
+section to view all the Dataview fields side-by-side (filters, iterations, label enumeration, etc.). The differences between the 
+experiments are highlighted. Obscure identical fields by switching on the `Hide Identical Fields` toggle. 
 
-1. Click the **DETAILS** tab **>** Expand the **DATAVIEWS** section, or, in the header, click <img src="/docs/latest/icons/ico-previous-diff.svg" alt="Previous diff" className="icon size-md" /> 
-   (Previous diff) or <img src="/docs/latest/icons/ico-next-diff.svg" alt="Next diff" className="icon size-md space-sm" /> (Next diff).
-1. Expand any of the following sections:
+The experiment on the left is used as the base experiment, to which the other experiments are compared. You can set a 
+new base experiment 
+in one of the following ways:
+* Click <img src="/docs/latest/icons/ico-switch-base.svg" alt="Switch base experiment" className="icon size-md space-sm" /> 
+on the top right of the experiment that will be the new base.
+* Click on the new base experiment and drag it all the way to the left
 
-   * **Augmentation** - On-the-fly data augmentation.
-   * **Filtering** 
-     * Frame inclusion and exclusion rules based on ROI labels
-     * Frame metadata
-     * Frame sources 
-     * Number of instances of a rule matching ROIs in each frame
-     * Confidence levels.
-   * **Iteration** - Iteration controls.
-   * **Labels Enumeration** - Class label enumeration.
-   * **Mapping** - ROI label translation.
-   * **View**
 
 ![Dataview comparison](../../img/hyperdatasets/web-app/compare_dataviews.png)
\ No newline at end of file