Skip to content

Commit 4948af8

Browse files
committed
apply auto-fixes
1 parent 76182f4 commit 4948af8

11 files changed

Lines changed: 83 additions & 80 deletions

File tree

docs/explore-and-author/graph-exploration/graph-insights/features/application-settings.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ Access global configuration via the top-left dropdown menu.
1515

1616
### Troubleshoot and Reset
1717

18-
1. **Reset local data:** Clears browser-side preferences (e.g., columns visibility, width, and position).
19-
2. **Reset graph data:** Performs a "Factory Reset" of the analysis for the current dataset.
18+
1. **Reset local data:** Clears browser-side preferences (e.g., columns visibility, width, and position).
19+
2. **Reset graph data:** Performs a "Factory Reset" of the analysis for the current dataset.
2020

2121
!!! danger "Destructive Action"
22-
22+
2323
**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.
2424

2525

@@ -42,4 +42,4 @@ When no group or connection is selected, the right pane displays the **database
4242

4343
![Database Summary Panel](../assets/database-summary.png){ class="bordered" width="30%" }
4444

45-
**Sorting:** Use the `Sort by` dropdown to order lists by `Name` (alphabetical) or `Quantity` (cardinality) to identify the largest entities.
45+
**Sorting:** Use the `Sort by` dropdown to order lists by `Name` (alphabetical) or `Quantity` (cardinality) to identify the largest entities.

docs/explore-and-author/graph-exploration/graph-insights/features/canvas-ui.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Graph Insights maintains a session history stack.
2828
![Undo Redo Controls](../assets/undo-redo.png){ class="bordered" width="40%" }
2929

3030
!!! warning "Rebuild on Undo"
31-
31+
3232
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.
3333

3434

@@ -48,6 +48,7 @@ If a group contains *more* resources than the limit, it is rendered as a single
4848
### Instance Rendering (Count ≤ Threshold)
4949

5050
If the count is *below* the limit, each resource is rendered as a dot within the group disk.
51+
5152
- The number inside each dot represents its [predecessor](objects.md#predecessors) count (number of resources in the left group linked by the connection). No number means there is only a single predecessor.
5253
- The resources with higher predecessor counts are located at the center of the group.
5354

@@ -65,8 +66,8 @@ Locate specific resources **among those currently visible** in the groups of the
6566
![Search Visible Objects](../assets/search-objects.png){ class="bordered" width="65%" }
6667

6768
!!! tip "Flags Management"
68-
69+
6970
Use the `Temporary flags` menu that appears on the top left of the canvas to manage the persistence of the temporary flags.
7071

7172

72-
---
73+
---

docs/explore-and-author/graph-exploration/graph-insights/features/category-tree.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11

22

3-
# All Explorations Start from the Class Tree
3+
# All Explorations Start from the Class Tree
44

55
The left pane is the **starting point of any exploration**, whether you want to **begin a fresh exploration** with a group from a class of the taxonomy or **recall a pre-existing exploration**.
66

77
![Sidebar Overview](../assets/left-sidebar.png){ class="bordered" width="30%" }
88

99
!!! warning "Further Information"
10-
10+
1111
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)**.
1212

1313

@@ -25,7 +25,7 @@ The tree displays the hierarchical taxonomy of the dataset:
2525

2626
The tree is the primary tool to populate the canvas:
2727

28-
- **Drag and drop (Start):** Dragging a class to an empty area clears the canvas and starts a new exploration with a group of the selected class.
28+
- **Drag and drop (Start):** Dragging a class to an empty area clears the canvas and starts a new exploration with a group of the selected class.
2929
*Alternatives: Double-click the class or use its context menu item `Start exploration with class`.*
3030
- **Drag and drop (Intersect):** Drag a class onto an **existing** group to apply an intersection filter (e.g., dragging `German Suppliers` onto `VIP Suppliers` restricts the group to resources with **both classes**).
3131

@@ -41,12 +41,12 @@ The tree is the primary tool to populate the canvas:
4141
- **Outcome:** The item turns **light gray**. Expansion steps will skip this class and offer **its direct sub-class** instead.
4242

4343
!!! danger "Caution"
44-
44+
4545
The resources that have **only deactivated classes** are **no longer reachable** via an exploration.
4646

4747

4848
!!! tip "Hiding Deactivated Items"
49-
49+
5050
You can toggle the visibility of deactivated items in the tree via the [application settings](application-settings.md#settings).
5151

5252

docs/explore-and-author/graph-exploration/graph-insights/features/connections.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,20 +16,20 @@ When a group with visible resources is expanded, or when a connected group direc
1616
![Connectivity Indicator](../assets/objects-without-successor.png){ class="bordered" width="75%" }
1717

1818
!!! info "Visual Partition"
19-
19+
2020
This indicator provides an instant "Visual Partition" of the set. For example, expanding `Supplier` → `Product` and filtering the products to `Confections` or `Beverages` dims all Suppliers who do not provide confections nor beverages.
2121

2222

2323
!!! tip "Missing Connections"
24-
24+
2525
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).
2626

2727

2828
---
2929

3030
## Left Group Restriction (Backpropagation) {#backpropagation}
3131

32-
By default, the exploration applies a **left-join pattern**: The left group remains static, while the right group contains the connected resources. The left group restriction switches (permanently) to an **inner-join pattern**, removing from the left group all resources having no successor in the right group.
32+
By default, the exploration applies a **left-join pattern**: The left group remains static, while the right group contains the connected resources. The left group restriction switches (permanently) to an **inner-join pattern**, removing from the left group all resources having no successor in the right group.
3333

3434
- **Action:** Right-click the connection to open its context menu and select `Restrict left group`.
3535
- **Outcome:**
@@ -39,14 +39,14 @@ By default, the exploration applies a **left-join pattern**: The left group rema
3939
![Backpropagation Connection Context](../assets/backpropagation-connection.png){ class="bordered" width="75%" }
4040

4141
!!! warning "Effects of Subsequent Updates"
42-
42+
4343
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.
4444

4545
In the example above, narrowing `Confections | Beverages` to `Beverages` only will remove from the `Supplier` group the ones who do not provide beverages.
4646

4747

4848
!!! hint "Multistep Backpropagation"
49-
49+
5050
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))
5151

5252

@@ -68,8 +68,8 @@ While the **[table of a group](objects-table.md)** lists resources, the **connec
6868

6969
To open it:
7070

71-
1. **Context Menu:** Right-click the connection and select `Show connection table`.
72-
2. **Quick Action:** Click the connection to select it, then click the blue `Show connection table...` button at the bottom of the canvas.
71+
1. **Context Menu:** Right-click the connection and select `Show connection table`.
72+
2. **Quick Action:** Click the connection to select it, then click the blue `Show connection table...` button at the bottom of the canvas.
7373

7474
### Table Components
7575

@@ -85,4 +85,4 @@ The table displays one row per object property assertion with predefined and var
8585

8686
- **Structural columns:** The resource and object property columns support **search** and **sorting**, but the filtering cannot be applied (filter the groups or select another object property instead).
8787
- **Data Property columns:** Full support with filtering like the [resource table](objects-table.md#filtering)
88-
- **Highlighting:** Hovering over a row highlights the corresponding connected resources in the exploration if the groups are in [instance rendering mode](canvas-ui.md#object-threshold-logic).
88+
- **Highlighting:** Hovering over a row highlights the corresponding connected resources in the exploration if the groups are in [instance rendering mode](canvas-ui.md#object-threshold-logic).

docs/explore-and-author/graph-exploration/graph-insights/features/groups.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Selecting a group opens the **group details** in the right pane.
1515
The header contains:
1616

1717
- The **group caption** that is either:
18-
- The caption of its class if no class filter was applied
18+
- The caption of its class if no class filter was applied
1919
- A "logical expression" of class captions describing the combination of class filter applied otherwise (see [histogram filtering](#filtering))
2020
- A structured **natural language description** of its contents that details all steps of the traversal.
2121

@@ -24,7 +24,7 @@ The header contains:
2424
The **histogram sections** display the distribution of classes within a group. It allows analysts to scrutinize class composition (eg. spot unexpected or missing classes) and perform logical set operations (union, intersection, difference) to restrict the contents of the groups.
2525

2626
- **Scope:** The panel displays counts for all **classes** (including **[user-defined classes](persistence.md#custom-categories)**) present within the selected group.
27-
*Remark: If user-defined classes are present, a second histogram is shown for better overview*
27+
*Remark: If user-defined classes are present, a second histogram is shown for better overview*
2828
- **Hierarchy:** Use the `(+)` icons to expand a class (e.g., `Confections`) to reveal the distribution of its sub-classes.
2929
- **Sorting:** Use the dropdown to order bars by `Name` (Alphabetical) or `Quantity` (Cardinality).
3030

@@ -41,7 +41,7 @@ Flagging highlights specific subsets of data for visual inspection without modif
4141
![Flagged Resources in Group](../assets/histogram-flagged-resources.png){ class="bordered" width="80%" }
4242

4343
!!! warning "Visibility Threshold"
44-
44+
4545
Flagging is only visible when the group is in **instance rendering mode** (count <= threshold). See the [threshold setting](canvas-ui.md#object-threshold-logic).
4646

4747

@@ -59,7 +59,7 @@ Histograms function as a visual facet query builder. Use the buttons to apply bo
5959
| **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. |
6060

6161
!!! warning "Multiple Histograms"
62-
62+
6363
When applying a filter, selections made **simultaneously in different histograms** are combined **conjunctively (AND)** in a facet-like logic.
6464

6565

@@ -74,14 +74,14 @@ As filters are applied, the **group caption** updates to reflect the mathematica
7474

7575
The **expansion menu** of a group presents the options available for adding a non-empty step to the traversal. It tells you which classes are reachable via which direction of which object properties.
7676

77-
1. **Action:** Click any group to open the menu.
78-
2. **Select:** The menu presents the hierarchy of connecting (directed) **object properties**, organized by target **class**.
77+
1. **Action:** Click any group to open the menu.
78+
2. **Select:** The menu presents the hierarchy of connecting (directed) **object properties**, organized by target **class**.
7979
- If the data model includes sub-object properties, point the parent object property to open the sub-menu with its child object property.*
80-
3. **Action:** Click a **object property** with the required direction for the selected target **class** to add a new connection beam to the exploration.
80+
3. **Action:** Click a **object property** with the required direction for the selected target **class** to add a new connection beam to the exploration.
8181

8282
![Expansion Menu](../assets/expansion-menu.png){ class="bordered" width="65%" }
8383

84-
4. **Alternative:** For schemas with deep object property hierarchies (or if you know exactly which object property) use the search bar to locate specific paths.
84+
1. **Alternative:** For schemas with deep object property hierarchies (or if you know exactly which object property) use the search bar to locate specific paths.
8585

8686
![Filtered Expansion Menu](../assets/expansion-menu-flattened.png){ class="bordered" width="65%" }
8787

@@ -97,6 +97,6 @@ Right-click a group or its caption to access its context menu.
9797
- **Show resource table:** Opens the tabular view (see the [dedicated page](objects-table.md)).
9898

9999
!!! tip "Usage"
100-
100+
101101
- The query is intended to be used directly on the database for various datasets with the same model (or slight variations thereof).
102102
- Use the notes to explain what is the content of the group in your own words. This is particularly relevant for collaborative work.

docs/explore-and-author/graph-exploration/graph-insights/features/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Documentation for the core components of the Graph Insights interface.
66

77
## Workspace
88

9-
- **[Application and dataset settings](application-settings.md):** Application fine-tuning, dataset selection.
9+
- **[Application and dataset settings](application-settings.md):** Application fine-tuning, dataset selection.
1010
- **[Exploration canvas](canvas-ui.md):** Layout controls, information density management, and exploration tree exports.
1111
- **[Class tree](category-tree.md):** Starting an exploration, class configuration (captions/visibility).
1212

@@ -20,4 +20,4 @@ Documentation for the core components of the Graph Insights interface.
2020
## Analysis Tools
2121

2222
- **[Histograms](groups.md#histograms):** class distribution analysis and facet-like set operations (union, intersection, difference).
23-
- **[Persistence](persistence.md):** Saved explorations, user-defined classes, and JSON sharing.
23+
- **[Persistence](persistence.md):** Saved explorations, user-defined classes, and JSON sharing.

docs/explore-and-author/graph-exploration/graph-insights/features/objects-table.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,10 @@ The resource table is the engine for refining the exploration tree. Apply filter
3232

3333
Filtering is a two-step process to prevent unnecessary database queries.
3434

35-
1. **Define and preview:** Set criteria in the column headers.
35+
1. **Define and preview:** Set criteria in the column headers.
3636
- **Outcome:** The table updates immediately to preview the result, and the column header displays an **hourglass icon (⧖)** (symbolizes filtering).
3737
- Repeat with further columns as necessary.
38-
2. **Apply:** Click `Apply filters` (top-left).
38+
2. **Apply:** Click `Apply filters` (top-left).
3939
- **Outcome:** The group on the canvas updates, and a **half full disk icon (◐)** appears on the group (indicating filtered content).
4040

4141
![Filter Status Icons](../assets/filtered-group-and-column.png){ class="bordered" width="85%" }
@@ -74,7 +74,7 @@ Unlike the bulk group export, table exports respect the **current view** (filter
7474
- **Copy SPARQL:** Copies the query used to generate the current table view.
7575

7676
!!! tip "Remarks"
77-
77+
7878
- The query is intended to be used directly on the database for various datasets with the same model (or slight variations thereof).
7979
- The table query was designed for dashboard integration. Make sure to configure the table to match exactly your requirements.
8080
- The query might look overcomplicated but it includes lots of special case handling to replicate the table view as close as possible.

0 commit comments

Comments
 (0)