diff --git a/docs/release-notes/v1.50-v1.59.md b/docs/release-notes/v1.50-v1.59.md
index cfd55571..94d67f24 100644
--- a/docs/release-notes/v1.50-v1.59.md
+++ b/docs/release-notes/v1.50-v1.59.md
@@ -526,6 +526,7 @@ Please review the documentation, as these changes may impact your integrations.
1. **Tabular Data Endpoint Changes**
* ??? abstract "Introduced changes to Tabular Data"
+
| Introduced change | Changes Description |
|:----------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Deprecating old response format | The old response format for tabular data will be deprecated. The **"multi_value"** response format (introduced in July 2023) will be the default option. It allows retrieval of data with one or more features and suits any type of tabular data, including **.gct** files. |
@@ -535,6 +536,7 @@ Please review the documentation, as these changes may impact your integrations.
* ??? danger "Affected endpoints (for both as-curator and as-users)"
+
| Endpoint Group | Endpoints Affected |
|:---------------------|:----------------------------------------------------------------------------------------------------------------------------------------|
| expressionUser | GET `/api/v1/as-user/expressions` GET `/api/v1/as-user/expressions/{id}` |
@@ -545,6 +547,7 @@ Please review the documentation, as these changes may impact your integrations.
2. **Variants Endpoint Changes**
* ??? abstract "Introduced changes to Variants"
+
| Introduced change | Changes Description |
|:----------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Introducing **“variant”** section | A new section **“variant”** contains all fields related to a specific variation from the original VCF file: CHROM, POS, ID, REF, ALT, QUAL, FILTER, INFO. |
@@ -553,6 +556,7 @@ Please review the documentation, as these changes may impact your integrations.
* ??? danger "Affected endpoints (for both as-curator and as-users)"
+
| Endpoint Group | Endpoints Affected |
|:---------------------|:----------------------------------------------------------------------------------------------------------------------------------------|
| variantUser | GET `/api/v1/as-user/variants` GET `/api/v1/as-user/variants/{id}` |
@@ -563,6 +567,7 @@ Please review the documentation, as these changes may impact your integrations.
3. **Flow Cytometry Endpoint Changes**
* ??? abstract "Introduced changes to Flow Cytometry"
+
| Introduced change | Changes Description |
|:----------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Introducing **“feature”** and **“value”** sections | Flow-cytometry data response now has section **“feature”** including **"readoutType"**, **"cellPopulation"** and **"marker"** fields. **“Value”** section contains the expression field which is renamed to **“value”**.|
@@ -572,6 +577,7 @@ Please review the documentation, as these changes may impact your integrations.
* ??? danger "Affected endpoints (for both as-curator and as-users)"
+
| Endpoint Group | Endpoints Affected |
|:---------------------|:----------------------------------------------------------------------------------------------------------------------------------------|
| flowCytometryUser | GET `/api/v1/as-user/flow-cytometries` GET `/api/v1/as-user/flow-cytometries/{id}` |
diff --git a/docs/user-guide/quick-start/consumer-gui.md b/docs/user-guide/quick-start/consumer-gui.md
index 5a7282a4..cf8bf99a 100644
--- a/docs/user-guide/quick-start/consumer-gui.md
+++ b/docs/user-guide/quick-start/consumer-gui.md
@@ -1,27 +1,34 @@
# Data Consumer in the User Interface
-This guide will help you navigate the main features of the Open Data Manager as a Data Consumer.
+This guide will help you navigate the main features of the Open Data Manager as a Data Consumer. Please note that all users are Consumers by default
## Main Page
-When you open ODM you will be taken to the start page or “Dashboard” as shown below:
+When you open ODM you will be taken to the start page or **Dashboard**. Here you can access important links to the Quick Start guide, the User Guides, and documentation for the API, and share your feedback.
+
+The main dashboard contains access to useful information, including Quick Start examples, User Guides, and API endpoints documentation
+
## Browse Studies
As a Data Consumer, you can browse and explore various studies.
-To search and browse studies, click on the **“Browse studies”** button on the dashboard/start page.
+To search and browse studies, click on the **Browse studies** button on the dashboard/start page.
+
+Browse studies: to search and browse studies, click on the Browse studies button on the dashboard/start page
+
## Search for Data
Apply filters to search for specific studies. For example, select filters using the criteria in the panel on the left,
such as Data Class, Organism, etc.
-!!! info "The exact filters you see may vary due to the data contained within your ODM system. Administrators can lock which facets are available for all users."
+!!! info
+ The exact filters you see may vary depending on the data contained within your ODM. Administrators can lock which facets are available for all users.
{ width="700" }
@@ -29,16 +36,19 @@ such as Data Class, Organism, etc.
The system's search functionality is designed to enhance user experience and efficiency by allowing users
-to look up specific keywords effortlessly. By entering terms such as **"bowel"**, users can quickly access a range
-of relevant studies. Additionally, the search bar is equipped with an intuitive autocomplete feature,
+to look up specific keywords effortlessly.
+By entering terms such as **"bowel"**, users can quickly access a range
+of relevant studies.
+
+Additionally, the search bar is equipped with an intuitive autocomplete feature,
which not only predicts and suggests potential search terms but also provides values from various ontologies.
This ensures a more streamlined and accurate search process, making it easier to navigate through the available
data and find pertinent information swiftly.
+
-
-Use the search bar to find specific keywords, such as **"bowel"** to display relevant studies.
-The autocomplete feature also suggests values from various ontologies.
+Use the search bar to find specific keywords, such as bowel to display relevant studies. The autocomplete feature also suggests values from various ontologies
+
## Select a Study
@@ -46,14 +56,21 @@ After applying the desired filters to narrow down your search results, you will
that match your criteria. To delve deeper into a specific study, simply click on the corresponding icon.
This action will open the study, allowing you to review its details and findings comprehensively.
+
+Once the filters have been applied, and you find a study of interest, click on it to open it.
+
The study will open in a new tab, where the following tabs can be explored:
-**Study:** Shows the study metadata.
-**Samples:** Contains all the samples' metadata.
-**Data:** Details of the files linked or attached to the study.
+- **Study:** Shows the study metadata.
+- **Samples:** Contains all the samples' metadata.
+- **Data:** Details of the files linked or attached to the study.
+
+
+The selected study displays three main tabs: Study, Samples, and Data, each offering different sets of information related to the study
+
### Accession number
@@ -61,7 +78,10 @@ In addition, a unique accession number is automatically generated for each study
The accession number allows you to identify the specific study and to further work with the study via API endpoints.
Learn more about API endpoints and functionalities in the API User Guide.
+
+Every study imported to the ODM contains a unique identifier named accession number. You can visualize the accession number on the Study tab, or you can copy the accession number by clicking on the top bar of the main page and selecting Copy accession
+
Every study imported to the ODM contains a unique identifier named accession number.
You can visualize the accession number on the Study tab, or you can copy the accession number
@@ -72,24 +92,48 @@ by clicking on the top bar of the main page and selecting “copy accession”
To visualize the study data:
1. Click on **Explore**.
- 
-2. Select an attribute to display. For example, "Age".
-3. A plot will be created showing the values for the attribute "Age".
- 
+
+ 
+ Click on the tab **Explore** to visualize the study details
+
+
+2. Select an attribute to display. For example, **Age**.
+3. A plot will be created showing the values for the attribute **Age**.
+
+
+ 
+ Select an attribute (numerical or string) to generate a plot displaying its values
+
+
+4. To combine up to two attributes, such as **Age** and **Disease** simply select another attribute from the menu.
-4. To combine up to two attributes, such as "Age" and "Disease" simply select another attribute from the menu.
- 
+
+ 
+ Combine up to two attributes to create various types of plots
+
5. To remove an attribute from your comparison click the :material-window-close: at the top right corner
of the attribute in the list or use **Reset** option to remove all the attributes.
- 
+
+
+ 
+ Remove attributes by clicking the **X** symbol
+
6. The plot combining two attributes displays informative data, such as sample count, and minimal and maximum values.
- 
+
+
+ 
+ Explore numerical data associated with the combined plot
+
7. To export the plot in SVG or PNG formats, simply hover over the top right corner of the plot. A menu with three dots :material-dots-horizontal: will appear, allowing you to select the desired format for download. The available formats for downloading the plot are SVG and PNG.
- 
+
+
+ 
+ Export combined and single attribute plots in SVG and PNG formats
+
## Export Data
@@ -101,7 +145,10 @@ Export all the information contained in the study. Note that some studies may ha
!!! warning "If some externally stored data is inaccessible due to its removal from the original external storage (the link to the storage is invalid), the study cannot be exported."
+
+Export the data by clicking on the Export option in the top right corner of the screen. Files will be compressed, and once ready, the folder can be downloaded to the user’s local computer
+
By following these steps, you can efficiently browse, visualize, and export data as a Data Consumer using
-the Interface of Open Data Manager.
+the Interface of the Open Data Manager.