Skip to content

Commit b8f2c23

Browse files
committed
group the Build navigation into four sections, CMEM-8189
The Build sidebar listed 22 pages flat and in no recognizable order, and the landing page used groups the sidebar did not have. - group the sidebar into Foundations, Tutorials, Guides and Reference - align the landing page cards with these groups and move Mapping Creator, Active learning and Project Access Control to Guides - shorten the card descriptions and give each card a one-line purpose - replace the Foundations and Guides card icons
1 parent e376610 commit b8f2c23

3 files changed

Lines changed: 540 additions & 524 deletions

File tree

‎docs/build/.pages‎

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,29 @@
11
---
22
nav:
33
- Build: index.md
4-
- Introduction to the User Interface: introduction-to-the-user-interface
5-
- Integrations: integrations
6-
- Task and Operator Reference: reference
7-
- Mapping Creator: mapping-creator
8-
- Mapping Creator Tutorial: mapping-creator-tutorial
9-
- Rule Operators: rule-operators
10-
- Rule Blocks: rule-blocks
11-
- Define Prefixes / Namespaces: define-prefixes-namespaces
12-
- Cool IRIs: cool-iris
13-
- Lift Tabular Data: lift-data-from-tabular-data-such-as-csv-xslx-or-database-tables
14-
- Lift Hierarchical Data: lift-data-from-json-and-xml-sources
15-
- Lift Web API Data: extracting-data-from-a-web-api
16-
- Workflows: workflows
17-
- Incremental Database Loading: loading-jdbc-datasets-incrementally
18-
- Connect to Snowflake: snowflake-tutorial
19-
- Active learning: active-learning
20-
- Link Intrusion Detection Systems to Open-Source INTelligence: tutorial-how-to-link-ids-to-osint
21-
- Variables: variables
22-
- Evaluate Template Operator: evaluate-template
23-
- Build Knowledge Graphs from Kafka Topics: kafka-consumer
24-
- Spark: spark
25-
- Project Access Control: project-access-control
4+
- Foundations:
5+
- Introduction to the User Interface: introduction-to-the-user-interface
6+
- Cool IRIs: cool-iris
7+
- Define Prefixes / Namespaces: define-prefixes-namespaces
8+
- Rule Operators: rule-operators
9+
- Spark: spark
10+
- Tutorials:
11+
- Mapping Creator Tutorial: mapping-creator-tutorial
12+
- Lift Tabular Data: lift-data-from-tabular-data-such-as-csv-xslx-or-database-tables
13+
- Lift Hierarchical Data: lift-data-from-json-and-xml-sources
14+
- Lift Web API Data: extracting-data-from-a-web-api
15+
- Incremental Database Loading: loading-jdbc-datasets-incrementally
16+
- Connect to Snowflake: snowflake-tutorial
17+
- Build Knowledge Graphs from Kafka Topics: kafka-consumer
18+
- Evaluate Template Operator: evaluate-template
19+
- Link Intrusion Detection Systems to Open-Source INTelligence: tutorial-how-to-link-ids-to-osint
20+
- Guides:
21+
- Mapping Creator: mapping-creator
22+
- Active learning: active-learning
23+
- Rule Blocks: rule-blocks
24+
- Workflows: workflows
25+
- Variables: variables
26+
- Project Access Control: project-access-control
27+
- Reference:
28+
- Task and Operator Reference: reference
29+
- Integrations: integrations

‎docs/build/index.md‎

Lines changed: 31 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -9,52 +9,60 @@ hide:
99

1010
# :material-star: Build
1111

12-
The Build stage turns your source data—across files, databases, APIs, and streams—into an Enterprise Knowledge Graph. The sections below explain the Build workspace and guide you from first lifting steps to reusable patterns and reference material.
12+
The Build stage turns source data from files, databases, APIs, and streams into an Enterprise Knowledge Graph.
1313

1414
**:octicons-people-24: Intended audience:** Linked Data Experts
1515

1616
<div class="grid cards" markdown>
1717

18-
- :eccenca-application-dataintegration: Foundations: Introduction and Best Practices
18+
- :material-lightbulb-outline: Foundations
1919

2020
---
2121

22-
- [Introduction to the User Interface](introduction-to-the-user-interface/index.md) --- a short introduction to the **Build** workspace incl. projects and tasks management.
23-
- [Rule Operators](rule-operators/index.md) --- Overview on operators that can be used to build linkage and transformation rules.
24-
- [Cool IRIs](cool-iris/index.md) --- URIs and IRIs are character strings identifying the nodes and edges in the graph. Defining them is an important step in creating an exploitable Knowledge Graph for your Company.
25-
- [Define Prefixes / Namespaces](define-prefixes-namespaces/index.md) --- Namespace declarations allow for abbreviation of IRIs by using a prefixed name instead of an IRI, in particular when writing SPARQL queries or Turtle.
26-
- [Spark](spark/index.md) --- Explainer of Apache Spark and its integration within the BUILD platform.
27-
- [Project Access Control](project-access-control/index.md) --- Restrict a project to the members of selected user groups.
22+
Understand the workspace and the concepts behind it.
23+
24+
- [Introduction to the User Interface](introduction-to-the-user-interface/index.md) --- The **Build** workspace, its projects and its tasks.
25+
- [Cool IRIs](cool-iris/index.md) --- Define the identifiers of the nodes and edges in a Knowledge Graph.
26+
- [Define Prefixes / Namespaces](define-prefixes-namespaces/index.md) --- Abbreviate IRIs with prefixed names.
27+
- [Rule Operators](rule-operators/index.md) --- The operators that make up linking and transformation rules.
28+
- [Spark](spark/index.md) --- Apache Spark and its integration in **Build**.
2829

2930
- :material-list-status: Tutorials
3031

3132
---
3233

34+
Follow an example from start to finish.
35+
3336
- [Build a mapping with the Mapping Creator](mapping-creator-tutorial/index.md) --- Map a hierarchical XML file to a vocabulary with the visual editor and its AI-generated suggestions.
34-
- [Lift Data from Tabular Data](lift-data-from-tabular-data-such-as-csv-xslx-or-database-tables/index.md) --- Build a Knowledge Graph from tabular data such as CSV, XSLX or database tables.
35-
- [Lift data from JSON and XML sources](lift-data-from-json-and-xml-sources/index.md) --- Build a Knowledge Graph based on input data from hierarchical sources such as JSON and XML files.
36-
- [Extracting data from a Web API](extracting-data-from-a-web-api/index.md) --- Build a Knowledge Graph based on input data from a Web API.
37-
- [Incremental Database Loading](loading-jdbc-datasets-incrementally/index.md) --- Load data incrementally from a JDBC Dataset (relational database Table) into a Knowledge Graph.
38-
- [Active learning](active-learning/index.md) --- Advanced workflows that improve results iteratively by incorporating feedback signals.
39-
- [Connect to Snowflake](snowflake-tutorial/index.md) --- Connect Snowflake as a scalable cloud warehouse and lift/link its data in Corporate Memory to unify it with your other sources in one knowledge graph.
40-
- [Build Knowledge Graphs from Kafka Topics](kafka-consumer/index.md) --- Consume Kafka topics and lift event streams into a Knowledge Graph.
41-
- [Evaluate Jinja Template and Send an Email Message](evaluate-template/index.md) --- Template and send an email after a workflow execution.
37+
- [Lift Data from Tabular Data](lift-data-from-tabular-data-such-as-csv-xslx-or-database-tables/index.md) --- Build a Knowledge Graph from CSV, XLSX or database tables.
38+
- [Lift data from JSON and XML sources](lift-data-from-json-and-xml-sources/index.md) --- Build a Knowledge Graph from hierarchical files.
39+
- [Extracting data from a Web API](extracting-data-from-a-web-api/index.md) --- Build a Knowledge Graph from a Web API response.
40+
- [Incremental Database Loading](loading-jdbc-datasets-incrementally/index.md) --- Load a relational database table incrementally through a JDBC dataset.
41+
- [Connect to Snowflake](snowflake-tutorial/index.md) --- Lift and link data from a Snowflake cloud warehouse.
42+
- [Build Knowledge Graphs from Kafka Topics](kafka-consumer/index.md) --- Consume Kafka topics and lift event streams.
43+
- [Evaluate Jinja Template and Send an Email Message](evaluate-template/index.md) --- Fill a template from a graph and send it after a workflow execution.
4244
- [Link Intrusion Detection Systems to Open-Source INTelligence](tutorial-how-to-link-ids-to-osint/index.md) --- Link IDS data to OSINT sources.
4345

44-
- :fontawesome-regular-snowflake: Patterns
46+
- :material-wrench-outline: Guides
4547

4648
---
4749

48-
- [Reconfigure Workflow Tasks](workflows/index.md) --- During its execution, new parameters can be loaded from any source, which overwrites originally set parameters.
49-
- [Project and Global Variables](variables/index.md) --- Define and reuse variables across tasks and projects.
50-
- [Rule Blocks](rule-blocks/index.md) --- Build re-usable, function-like transformation sequences which are referenced from transformation and linking rules and managed centrally.
50+
Use a feature in a project.
51+
52+
- [Mapping Creator](mapping-creator/index.md) --- Create and manage mappings on a visual canvas.
53+
- [Active learning](active-learning/index.md) --- Learn a linking rule from interactively labeled record pairs.
54+
- [Rule Blocks](rule-blocks/index.md) --- Build reusable transformation sequences, referenced from transformation and linking rules and managed centrally.
55+
- [Workflows](workflows/index.md) --- Orchestrate datasets and tasks, and reconfigure tasks during execution.
56+
- [Variables](variables/index.md) --- Define and reuse global, project and execution variables.
57+
- [Project Access Control](project-access-control/index.md) --- Restrict a project to the members of selected user groups.
5158

5259
- :material-book-open-variant-outline: Reference
5360

5461
---
5562

56-
- [Mapping Creator](mapping-creator/index.md) --- Create and manage mappings to lift legacy data into a Knowledge Graph.
57-
- [Integrations](integrations/index.md) --- Supported integrations and configuration options for connecting data sources and sinks.
58-
- [Task and Operator Reference](reference/index.md) --- Reference documentation for tasks and operators in the Build workspace.
63+
Look up tasks, operators and supported services.
64+
65+
- [Task and Operator Reference](reference/index.md) --- Tasks and operators of the **Build** workspace.
66+
- [Integrations](integrations/index.md) --- Services and applications that integrate with Corporate Memory.
5967

6068
</div>

0 commit comments

Comments
 (0)