Update example-use-2.md

Author: lcodo

docs/metadata-catalogue/example-use-2.md

@@ -0,0 +1,193 @@
+# DataTools4Heart Catalogue  
+
+1. [Introduction](#1-introduction)  
+2. [Homepage](#2-homepage)  
+3. [Main Navigation Overview](#3-main-navigation-overview)  
+4. [Repository Section](#4-repository-section)  
+   - [Repository Overview](#41-repository-overview)  
+   - [Individual Studies](#42-individual-studies)  
+   - [Study Detail Page](#43-study-detail-page)  
+   - [Datasets](#44-datasets)  
+   - [Variables](#45-variables)  
+5. [Search Functionality](#5-search-functionality)  
+6. [Data Access Process (Public View)](#6-data-access-process-public-view)  
+7. [Approved Projects (Public View)](#7-approved-projects-public-view)  
+8. [Tips for Navigation](#8-tips-for-navigation)  
+9. [Troubleshooting & FAQ (Public Access)](#9-troubleshooting--faq-public-access)  
+10. [Glossary (Relevant Terms)](#11-glossary-relevant-terms)  
+
+---
+
+## 1. Introduction
+
+The **DataTools4Heart Catalogue** is an AI-ready cardiology dataset discovery portal based on the **Mica (OBiBa)** platform.  
+It provides public access to study metadata, dataset descriptions, variables, and access request procedures.
+It does **not** host raw individual-level data; rather, it provides metadata, summary statistics and information on how to gain access
+
+This manual explains how to navigate the **public-facing** sections of the catalogue.
+
+---
+
+## 2. Homepage
+
+When you access the website, the homepage introduces the catalogue and provides the main navigation menu.
+
+**Screenshot Placeholder:**  
+`![Homepage](images/homepage.png)`
+
+The landing page shows a top navigation menu with:
+- A search bar (“Search networks, studies, datasets and variables …”) to type keywords. 
+- Quick links to Individual Studies, Collected Datasets, Variables.
+
+Also a brief description of the  catalogue content with some statistics, like the number of variables or datasets.
+
+---
+
+## 3. Main Navigation Overview
+
+The top navigation bar usually contains links such as:
+- **Home**
+- **Repository**
+- **Data Access Process**
+- Other informational pages (About, Contact, etc.)
+
+---
+
+## 4. Repository Section
+
+### 4.1 Repository Overview
+
+The Repository serves as the entry point to studies, datasets, and variables.
+
+**Screenshot Placeholder:**  
+`![Repository Overview](images/repository_overview.png)`
+
+You can explore metadata in read-only mode without logging in.
+
+---
+
+### 4.2 Individual Studies
+
+Clicking on *Individual Studies* displays a list of cardiology-related studies.
+
+**Screenshot Placeholder:**  
+`![Studies List](images/studies_list.png)`
+
+Each study entry usually shows:
+- Study title
+- Brief description
+- Metadata or links to datasets
+
+You can click on any study to see more details.
+
+---
+
+### 4.3 Study Detail Page
+
+A public study page typically includes:
+- Description
+- Objectives
+- Institutions or data owners
+- Datasets linked to that study
+
+**Screenshot Placeholder:**  
+`![Study Example](images/study_example.png)`
+
+---
+
+### 4.4 Datasets
+
+Under *Collected Datasets*, you can view a public list of available dataset descriptions.
+
+**Screenshot Placeholder:**  
+`![Datasets List](images/datasets_list.png)`
+
+Information may include:
+- Dataset title
+- Associated study
+- Brief overview
+
+---
+
+### 4.5 Variables
+
+The *Variables* section allows public browsing of variable names and limited metadata.
+
+**Screenshot Placeholder:**  
+`![Variables List](images/variables_list.png)`
+
+Users can typically see:
+- Variable label/name
+- Source (study/dataset)
+- Data type or category (if displayed publicly)
+
+---
+
+## 5. Search Functionality
+
+The catalogue includes a global search bar or a dedicated search page. You can search studies, datasets, or variables by keywords.
+
+**Screenshot Placeholder:**  
+`![Search Page](images/search_page.png)`
+
+---
+
+## 6. Data Access Process (Public View)
+
+A dedicated page explains:
+- Steps to request data
+- Eligibility or governance structure
+- Policies and conditions
+
+**Screenshot Placeholder:**  
+`![Data Access Process](images/data_access_process.png)`
+
+As a public user, you can read the procedures before any account-based actions.
+
+---
+
+## 7. Approved Projects (Public View)
+
+Some catalogues display a public list of projects that have already obtained data access.
+
+**Screenshot Placeholder:**  
+`![Approved Projects](images/approved_projects.png)`
+
+This section may include:
+- Project title
+- Lead institution
+- Summary or objectives
+
+---
+
+## 8. Tips for Navigation
+
+- Use the main menu to switch quickly between sections.
+- Explore the Repository first to understand the scope of cardiology datasets.
+- Use keywords in the search bar to find relevant studies or variables quickly.
+- Public view generally does **not** allow data downloads or detailed variable inspection.
+
+---
+
+## 9. Troubleshooting & FAQ (Public Access)
+
+| Issue | Explanation | Suggested Action |
+|------|-------------|-------------------|
+| Limited metadata visibility | Public mode hides detailed fields | Consider contacting catalogue administrators |
+| No download option | Public view does not include direct access | Refer to the Data Access Process page |
+| Broken links or missing info | Under maintenance or restricted | Wait or report to support contacts |
+
+
+---
+
+## 10. Glossary (Relevant Terms)
+
+- **Mica / OBiBa**: Software platform for metadata cataloguing and data access management.
+- **Study**: A research initiative providing structured datasets.
+- **Dataset**: A collection of data fields associated with a study. In DT4H context, it corresponds to a group of features hosted in a particular federated node.
+- **Variable**: A specific data element or field within a dataset. In DT4H context, it corresponds to AI-ready features
+- **Data Access Request**: Formal process for requesting restricted data.
+
+- Tutorials for requesting AI-ready cardiology data
+
+---