Merge pull request #218 from MaximilianWenzel/bugfix/graph-insights-screenshot-and-template-sync

rpietzsch · web-flow · commit 5850bc23e886 · 2026-02-27T12:49:15.000+01:00
fix: sync tutorial screenshots, resolve indefinite article grammar, ensure consistent indentation for alerts
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/object-dossier.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/object-dossier.png
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/object-flag-and-note.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/object-flag-and-note.png
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/relation-table.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/relation-table.png
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-usa-customer-filter.png b/docs/explore-and-author/graph-exploration/graph-insights/assets/tutorial-usa-customer-filter.png
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/concepts.md b/docs/explore-and-author/graph-exploration/graph-insights/concepts.md
@@ -100,4 +100,4 @@ Narrow down any group to match your current focus using [data property filters](
 - **Images:** [Export](features/persistence.md#export-visuals) the canvas as SVG or PNG images.
 - **CSV data:** Download of the resources of a group or of the table view of a group or connection.
 - **Query snippets:** Copy the SPARQL that returns the resources of a group or the data in the table view of a group or connection for use (e.g. a dashboard).
-- **[JSON Sharing](features/persistence.md#json-sharing):** Share explorations as JSON-serialization.
+- **[JSON Sharing](features/persistence.md#json-sharing):** Share explorations as JSON-serialization.
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md b/docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md
@@ -19,7 +19,7 @@ Access global configuration via the top-left dropdown menu.
 2.  **Reset graph data:** Performs a "Factory Reset" of the analysis for the current dataset.
 
 !!! danger "Destructive Action"
-    
+
     **Reset graph data** permanently deletes all [user-defined classes](persistence.md#custom-categories) and [saved explorations](persistence.md#saved-explorations) associated with the current database. This cannot be undone.
 
 
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md b/docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md
@@ -28,7 +28,7 @@ Graph Insights maintains a session history stack.
 ![Undo Redo Controls](../assets/undo-redo.png){ class="bordered" width="40%" }
 
 !!! warning "Rebuild on Undo"
-    
+
     Some operations (e.g., [user-defined classes](persistence.md#custom-categories) operations) have persistent side effects that may require a rebuild of the exploration state when moving back in the history.
 
 
@@ -65,7 +65,7 @@ Locate specific resources **among those currently visible** in the groups of the
 ![Search Visible Objects](../assets/search-objects.png){ class="bordered" width="65%" }
 
 !!! tip "Flags Management"
-    
+
     Use the `Temporary flags` menu that appears on the top left of the canvas to manage the persistence of the temporary flags.
 
 
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md b/docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md
@@ -7,7 +7,7 @@ The left pane is the **starting point of any exploration**, whether you want to
 ![Sidebar Overview](../assets/left-sidebar.png){ class="bordered" width="30%" }
 
 !!! warning "Further Information"
-    
+
     This section focuses on the **class tree**. See the persistence page for **[saved explorations](persistence.md#saved-explorations)** and **[user-defined classes](persistence.md#custom-categories)**.
 
 
@@ -41,17 +41,17 @@ The tree is the primary tool to populate the canvas:
 - **Outcome:** The item turns **light gray**. Expansion steps will skip this class and offer **its direct sub-class** instead.
 
 !!! danger "Caution"
-    
+
     The resources that have **only deactivated classes** are **no longer reachable** via an exploration.
 
 
 !!! tip "Hiding Deactivated Items"
-    
+
     You can toggle the visibility of deactivated items in the tree via the [application settings](application-settings.md#settings).
 
 
 ---
 
 ## Class Tree Configuration Reset
 
-To return the class tree configuration to its initial state, click the **circular arrow icon** in the pane header. This action restores all deactivated classes and reverts caption settings to defaults.
+To return the class tree configuration to its initial state, click the **circular arrow icon** in the pane header. This action restores all deactivated classes and reverts caption settings to defaults.
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/connections.md b/docs/explore-and-author/graph-exploration/graph-insights/features/connections.md
@@ -16,12 +16,12 @@ When a group with visible resources is expanded, or when a connected group direc
 ![Connectivity Indicator](../assets/objects-without-successor.png){ class="bordered" width="75%" }
 
 !!! info "Visual Partition"
-    
+
     This indicator provides an instant "Visual Partition" of the set. For example, expanding `Supplier` &rarr; `Product` and filtering the products to `Confections` or `Beverages` dims all Suppliers who do not provide confections nor beverages.
 
 
 !!! tip "Missing Connections"
-    
+
     This feature is useful to spot single resources that are missing expected connections (the expected connections missing at the group level can be identified in the expansion menu of the group).
 
 
@@ -39,14 +39,14 @@ By default, the exploration applies a **left-join pattern**: The left group rema
 ![Backpropagation Connection Context](../assets/backpropagation-connection.png){ class="bordered" width="75%" }
 
 !!! warning "Effects of Subsequent Updates"
-    
+
     Because the switch to an **inner-join pattern** is permanent, any further filtering of the right group will modify the contents of the right group.
 
     In the example above, narrowing `Confections | Beverages` to `Beverages` only will remove from the `Supplier` group the ones who do not provide beverages.
 
 
 !!! hint "Multistep Backpropagation"
-    
+
     To combine constraints from a variety of traversals conjunctively, restrictions are often propagated back to the start node of the exploration (see the [Supply Chain Analysis Tutorial](../tutorial.md#backpropagation)) 
 
 
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/groups.md b/docs/explore-and-author/graph-exploration/graph-insights/features/groups.md
@@ -41,7 +41,7 @@ Flagging highlights specific subsets of data for visual inspection without modif
 ![Flagged Resources in Group](../assets/histogram-flagged-resources.png){ class="bordered" width="80%" }
 
 !!! warning "Visibility Threshold"
-    
+
     Flagging is only visible when the group is in **instance rendering mode** (count <= threshold). See the [threshold setting](canvas-ui.md#object-threshold-logic).
 
 
@@ -59,7 +59,7 @@ Histograms function as a visual facet query builder. Use the buttons to apply bo
 | **Intersection (AND)** | **Sequential** Operation | 1. Restrict to `Class A`.<br>2. Select `Class B` in the updated list.<br>3. Restrict to `Class B`.<br>**Outcome:** Items that are **BOTH** A and B. |
 
 !!! warning "Multiple Histograms"
-    
+
     When applying a filter, selections made **simultaneously in different histograms** are combined **conjunctively (AND)** in a facet-like logic.
 
 
@@ -77,7 +77,7 @@ The **expansion menu** of a group presents the options available for adding a no
 1.  **Action:** Click any group to open the menu.
 2.  **Select:** The menu presents the hierarchy of connecting (directed) **object properties**, organized by target **class**.    
     - If the data model includes sub-object properties, point the parent object property to open the sub-menu with its child object property.*
-3.  **Action:** Click a **object property** with the required direction for the selected target **class** to add a new connection beam to the exploration.
+3.  **Action:** Click an object property with the required direction for the selected target **class** to add a new connection beam to the exploration.
 
 ![Expansion Menu](../assets/expansion-menu.png){ class="bordered" width="65%" }
 
@@ -97,6 +97,6 @@ Right-click a group or its caption to access its context menu.
 - **Show resource table:** Opens the tabular view (see the [dedicated page](objects-table.md)).
 
 !!! tip "Usage"
-    
+
     - The query is intended to be used directly on the database for various datasets with the same model (or slight variations thereof).
     - Use the notes to explain what is the content of the group in your own words. This is particularly relevant for collaborative work.
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md b/docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md
@@ -74,7 +74,7 @@ Unlike the bulk group export, table exports respect the **current view** (filter
 - **Copy SPARQL:** Copies the query used to generate the current table view.
 
 !!! tip "Remarks"
-    
+
     - The query is intended to be used directly on the database for various datasets with the same model (or slight variations thereof).
     - The table query was designed for dashboard integration. Make sure to configure the table to match exactly your requirements.
     - The query might look overcomplicated but it includes lots of special case handling to replicate the table view as close as possible.
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/objects.md b/docs/explore-and-author/graph-exploration/graph-insights/features/objects.md
@@ -14,7 +14,7 @@ Select a visible resource in a group or its row in the group table to open the `
 
 ### Components
 
-1.  **Header:** Displays the **caption** and **description** , as well as the IRI of the resource .
+1.  **Header:** Displays the **caption** and **description** , as well as the IRI of the resource.
 2.  **Classes:** List of all classes assigned to the resource.
 3.  **Data Properties:** List of all data properties organized in sections by their "usage domain" classes (see below).
 
@@ -23,7 +23,7 @@ Select a visible resource in a group or its row in the group table to open the `
 - **Copy Data:** Right-click any row to copy the **data property** or **data property assertion**.
 
 !!! info "Why are there sections?"
-    
+
     - Graph Insights analyses the actual graph data and infers at which level of the class hierarchy each data properties is effectively used. Besides giving some insights about the real usage domain of data properties, it is used to prevent the [resources table](objects-table.md) of the higher level classes from being "polluted" by all specific data properties of all their sub-classes.
     - If a data property is "defined" by multiple classes (e.g., `rdfs:label` used by both `Clothing` and `SeasonalCollection`), Graph Insights groups them into a shared section (e.g., `Clothing & SeasonalCollection`) to avoid duplication.
 
@@ -43,10 +43,10 @@ The standard flags are persistent markers used to track the appearance of specif
 - **Outcome:** A flag of the selected color displaying the caption is attached to every visible occurrence of the resource in the exploration tree.
 - **Alternative:** Click `Add note` to flag the object and attach a text comment to the flag. The note appears in the tooltip on hover.
 
-![Object Flag and Note](../assets/object-flag-and-note.png){ class="bordered" width="60%" }
+![Object Flag and Note](../assets/object-flag-and-note.png){ class="bordered" width="80%" }
 
 !!! info "About Persistence"
-    
+
     - A flag will appear anytime a new instance of the flagged resource is visible in a subsequent exploration step (even in new explorations).
     - Flags and notes can be removed using the context-menu of the resource, the group, or the exploration (canvas). 
 
@@ -64,7 +64,7 @@ Most flagging actions that might affect numerous nodes create temporary flags fo
 ![Temporary Flags Dropdown](../assets/temporary-vs-permanent-flags.png){ class="bordered" width="80%" }
 
 !!! tip "Useful Tip"
-    
+
     Add a standard flag to a temporarily flagged resource you identified via a global search and clear the temporary flags for a cleaner exploration.
 
 
@@ -89,7 +89,7 @@ Visualize upstream and downstream connections of a resource in the exploration t
 ![Branch Highlighting](../assets/flag-predecessors-successors.png){ class="bordered" width="95%" }
 
 !!! warning "Line of Sight"
-    
+
     Path highlighting is blocked by **count-only groups** (count > threshold).
 
 
@@ -113,7 +113,7 @@ In the **groups in instance rendering mode** (count <= threshold), Graph Insight
 Analysts can focus on a specific resource within a group to analyze its relationships.
 
 !!! warning "Prerequisite"
-    
+
     - These actions require the group containing the object to be in **instance rendering mode** (resources visible).
         - If it is not the case, consider reducing the group size by filtering or directly selecting the resource from the resources table of the group.
     - Locate the resource via [search](canvas-ui.md#global-search) or the [resource table](objects-table.md).
@@ -129,7 +129,7 @@ Expand the exploration with specific connections from a single resource within a
 ![Expand Individual Object](../assets/expand-object-from-group.png){ class="bordered" width="75%" }
 
 !!! info "Independence of the Explorations"
-    
+
     The resource exploration does not depend on the exploration that leads to the group. Any change to the main exploration either preserves the resource exploration (if the resource is still visible) or drops it (if the resource is no longer visible).
 
 
@@ -140,4 +140,4 @@ Start a new exploration tree with a specific resource found in the current explo
 - **Action:** Right-click the resource to open its context menu and select `Start exploration with resource`.
 - **Outcome:** The canvas clears and places the single resource as starting point of the exploration.
 
-![Start Exploration with Object](../assets/start-exploration-with-object.png){ class="bordered" width="70%" }
+![Start Exploration with Object](../assets/start-exploration-with-object.png){ class="bordered" width="70%" }
diff --git a/docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md b/docs/explore-and-author/graph-exploration/graph-insights/features/persistence.md
@@ -5,7 +5,7 @@
 Graph Insights provides mechanisms to persist analysis logic, annotate findings, and extend the class taxonomy. This page covers **saving and sharing explorations**, **group annotations**, and **user-defined classes**.
 
 !!! info "Dynamic Persistence"
-    
+
     Saved items preserve the **query logic** (the sequence of expansions and filters), not a static snapshot of data. If the underlying dataset changes, loading a saved exploration will reflect the current state of the database.
 
 
@@ -18,7 +18,7 @@ A **saved exploration** preserves the **structure** of the analysis: classes of
 To save the current exploration, either right-click the canvas background to open the exploration context menu or open the `Exploration` top menu, then select `Save exploration`.
 
 !!! warning "Structure over Layout"
-    
+
     The **structure** is not the exact **visual layout** (x/y coordinates). When loaded, the exploration tree re-arranges itself for optimal readability, adapting the rendering to the possibly modified number of resources in the groups.
 
 
@@ -47,7 +47,7 @@ Add context to the analysis by attaching text notes to important groups.
 ![Saved Exploration Context Menu](../assets/save-exploration-context-menu-and-notes.png){ class="bordered" width="75%" }
 
 !!! tip "Notes as Documentation"
-    
+
     The notes are persisted in saved explorations to allow documentation for future usage.
 
 
@@ -71,13 +71,13 @@ A user-defined Graph Insights class can be defined for any group in any explorat
 
 
 !!! info "Non-Destructive Model Refinement"
-    
+
     User-defined classes are **non-destructive**. They exist only in the visualization layer and do **not** write changes back to the RDF store.
 
 
 
 !!! tip "Hints"
-    
+
     - User-defined classes also appear in an additional specific Graph Insights class histogram for improved visibility (e.g. it allows you to see at first glance how many "High-Risk Suppliers" exist within a larger "Supplier" group).
     - You can create a user-defined class based on *another* user-defined class.
 
@@ -94,7 +94,7 @@ Share an exploration serialized as a JSON string.
 3.  **Import:** The recipient selects `Start exploration from JSON` from the canvas context menu or the `Exploration` top menu, and pastes the string.
 
 !!! warning "Limitations"
-    
+
     The success of exploration sharing on distinct servers depends greatly on the similarity between the source and target dataset and the specificity of the exploration. Sharing an exploration is in fact just like sharing multiple complex queries.
 
 
@@ -107,5 +107,4 @@ Export the current canvas state for reporting.
 - **Access:** Right-click the canvas background or use the `Exploration` top menu.
 - **Formats:**
     - **Raster (PNG):** For slides and quick sharing.
-    - **Vector (SVG):** For high-resolution print or editing.
-  
+    - **Vector (SVG):** For high-resolution print or editing.
