proofread new pages

minimal GraphInsights docu

Author: rpietzsch

docs/build/mapping-creator/index.md

@@ -9,8 +9,8 @@ tags:
 
 ## Configuration Info
 
-A specific configuration is require to activate this feature.
-Furthermore, for best experience an LLM provider configuration is also needed.
+A specific configuration is required to activate this feature.
+Furthermore, for the best experience, an LLM provider configuration is also needed.
 See the link in the info box for details.
 
 !!! info "Configuration"
@@ -19,7 +19,7 @@ See the link in the info box for details.
 
 ## Usage
 
-The Mapping Creator is  a feature of BUILD transformation tasks (_BUILD_> _Project_> (_Workflow_>) _Transformation_> _Mapping Creator_).
+The Mapping Creator is a feature of BUILD transformation tasks (_BUILD_ > _Project_ > (_Workflow_ >) _Transformation_ > _Mapping Creator_).
 
 !!! question "Help"
 
@@ -28,7 +28,7 @@ The Mapping Creator is  a feature of BUILD transformation tasks (_BUILD_> _Proje
     Access help and a feature tour via the help menu :eccenca-item-question:.
 
 Use the Mapping Creator to connect your data to semantic models.
-Using visual tools, drag-and-drop, and suggestions, you are able to create mappings between your source data and knowledge graph classes as well as their properties.
+Using visual tools, drag-and-drop, and suggestions, you can create mappings between your source data and knowledge graph classes as well as their properties.
 
 ![Mapping Creator](mapping-creator.png){ class="bordered" }
 
@@ -55,13 +55,13 @@ Each color and visual element used in the Mapping Creator has a specific meaning
 ### Manual creation
 
 To start a mapping you need to select or define a target class first.
-The target class defines where your data will be be mapped in the knowledge graph.
+The target class defines where your data will be mapped in the knowledge graph.
 
 #### Add properties
 
 ![Resource edit actions](mapping-creator-edit-actions.png){ class="bordered" width="40%" }
 
-To complete a mapping properties need to be added to complete your desired target schema (i.e. the graph fragment that your transformation shall yield).
+To complete a mapping, properties need to be added to complete your desired target schema (i.e. the graph fragment that your transformation shall yield).
 
 There are two options to add properties:
 
@@ -75,7 +75,7 @@ There are two options to add properties:
 In the _add target class_ dialog you may select different kind of properties:
 
 -   class properties - properties defined in the domain of the selected class or its super-classes
--   default properties - typical well knows like `rdfs:label` or `rdfs:comment`
+-   default properties - typical well-known properties like `rdfs:label` or `rdfs:comment`
 -   generic properties - properties defined with no explicit domain (or in domain of `owl:Thing`)
 
 The property preview helps to confirm your choice.
@@ -84,7 +84,7 @@ The property preview helps to confirm your choice.
 
 ![Adding a property from your vocabulary](mapping-creator-property-selection.png){ class="bordered" width="80%" }
 
-The _add property from vocabularies_ dialog allows to search and select a property and to configure it in the desired way:
+The _add property from vocabularies_ dialog allows you to search and select a property and to configure it in the desired way:
 
 -   redefine the role of a property, to use a DatatypeProperty in the role of an ObjectProperty, or vice versa
 -   define the _direction_ an ObjectProperty should be used in
@@ -126,7 +126,7 @@ You can accept (:octicons-thumbsup-16:) or reject (:octicons-thumbsdown-16:) eac
 
 ![Smart Property Suggestions](smart-suggestions.png){ class="bordered" }
 
-Once the smart suggestions have been generated, you need do two steps:
+Once the smart suggestions have been generated, you need to perform two steps:
 
 1. For each property, decide whether to accept or reject the AI-generated mapping.
     Click :octicons-thumbsup-16: Confirm to accept or :octicons-thumbsdown-16: Decline to reject.

docs/explore-and-author/companion/index.md

@@ -11,20 +11,22 @@ The Companion view enables you to interact with your data, graphs, vocabularies,
 
 ## Configuration Info
 
-A specific configuration is require to activate this feature.
-Our deployment templates (helm charts and docker-compose configurations) provide testes configuration profiles for different LLM providers.
+A specific configuration is required to activate this feature.
+Our deployment templates (helm charts and docker-compose configurations) provide tested configuration profiles for different LLM providers.
 See the link in the info box for details.
 
 !!! info "Configuration"
 
     See [`spring.ai.*` configuration properties in _Configuration of Servlet Container_](../../deploy-and-configure/configuration/explore/dataplatform/application-full.md#configuration-of-servlet-container) to learn how to enable and configure this feature.
     Explore uses _Spring AI_ to connect and configure LLM provider, as such the [Spring AI Chat Model API Configuration Reference](https://docs.spring.io/spring-ai/reference/api/chatmodel.html) applies.
 
+For optimal results, we recommend using Anthropic or OpenAI frontier-level models configured through the native Spring AI provider setup.
+
 ## Usage
 
 ![Companion Menu Button](companion-button.png){ class="bordered" width="40%" }
 
-You can open the _Chat with Companion_ from any explore module via the :eccenca-application-ai-suggestion: Companion button the top right of the application header, next to the :eccenca-application-useraccount: user menu.
+You can open the _Chat with Companion_ from any explore module via the :eccenca-application-ai-suggestion: Companion button in the top right of the application header, next to the :eccenca-application-useraccount: user menu.
 
 ![Companion Chat](companion-anatomy.jpg){ class="bordered" width="60%" }
 
@@ -33,13 +35,13 @@ In the companion sidebar, use:
 -   :eccenca-toggler-maximize: to increase the size of the sidebar
 -   :eccenca-toggler-minimize: to decrease the size of the sidebar
 -   :eccenca-item-add-artefact: to start a new conversation
--   the dropdown menu to select or search for a conversation
+-   :octicons-triangle-down-24: the dropdown menu to select or search for a conversation
 -   :eccenca-item-upload: to add documents as context to the chat (supported formats include `pdf`, `txt` and `md`)
 -   :eccenca-item-wrench: to configure the tools that the LLM can use to answer.
--   :eccenca-item-wrench: to use your microphone to dictate your questions
+-   :eccenca-item-microphone: to use your microphone to dictate your questions
 -   :material-send-variant-outline: to submit your question
 
-To maximise the relevance and accuracy of the generated answer, your question is automatically enriched based on the context of the current view (e.g. the query text, the graph and the resource IRI).
+To maximize the relevance and accuracy of the generated answer, your question is automatically enriched based on the context of the current view (e.g. the query text, the graph and the resource IRI).
 
 ### Tool selection
 
@@ -59,7 +61,7 @@ If your use case or question requires you to limit the available tools (e.g. if
 
     `query_execute_saved`
     :   Executes a saved SPARQL query on this corporate memory instance.
-    The query is identified by it's IRI.
+    The query is identified by its IRI.
 
 -   Query related:
 
@@ -86,17 +88,17 @@ If your use case or question requires you to limit the available tools (e.g. if
 
     `vocabularies_property_list`
     :   All Properties defined in this knowledge graph by installed vocabularies.
-    While all properties are returned, they can easy be grouped by either their explicit association with an ontology in the isDefinedBy (`rdfs:isDefinedBy`) field, or by the sourceGraph field, which contains the names of the graphs from which the type statements were loaded from.
+    While all properties are returned, they can easily be grouped by either their explicit association with an ontology in the isDefinedBy (`rdfs:isDefinedBy`) field, or by the sourceGraph field, which contains the names of the graphs from which the type statements were loaded.
 
     `vocabularies_class_list`
     :   All Classes defined in this knowledge graph by installed vocabularies.
-    While all classes are returned, they can easy be grouped by either their explicit association with an ontology in the isDefinedBy (`rdfs:isDefinedBy`) field, or by the sourceGraph field, which contains the names of the graphs from which the type statements were loaded from.
+    While all classes are returned, they can easily be grouped by either their explicit association with an ontology in the isDefinedBy (`rdfs:isDefinedBy`) field, or by the sourceGraph field, which contains the names of the graphs from which the type statements were loaded.
 
 -   Resource related
 
     `resource_search`
     :   Performs a lucene syntax full text search of labels and descriptions for 'searchTerm' and retrieve list of best matches.
-    The context graph will restrict the search to it includes, or search the full graph. Pattern allows to define a `SPARQL WHERE` clause snippet, which defaults to `{GRAPH ?contextGraph {?resource ?p ?o}}`.
+    The context graph will restrict the search to its includes, or search the full graph. Pattern allows to define a `SPARQL WHERE` clause snippet, which defaults to `{GRAPH ?contextGraph {?resource ?p ?o}}`.
     Search will always be on the `?resource`, so adjust the pattern, if needed.
 
     `resource_get`

docs/explore-and-author/graph-exploration/graph-insights/explore-graph-insights.png

@@ -6,25 +6,39 @@ tags:
 ---
 # Graph Insights
 
+![Explore - Graph Insights](explore-graph-insights.png "Explore - Graph Insights"){ class="bordered" }
+
 ## Introduction
 
-...
+Graph Insights allows you to explore your knowledge graph through grouped nodes and aggregated relations to keep the view readable.
+Expansions are data-guided to avoid dead ends, while on-demand details give you context without clutter.
+Interactive filters help you shape the exploration, building query paths with class, attribute, and relation filters along the way.
+Each exploration can be converted to SPARQL, effectively serving as a no-code query builder. This also provides table-like views for users less familiar with graphs.
+
+## Configuration Info
+
+A specific configuration is required to activate this feature.
+
+!!! info "Configuration"
+
+    See [Graph Insights Configuration](../../../deploy-and-configure/configuration/graphinsights/index.md) to learn how to enable and configure this feature.
 
+<!--
 ## Usage
 
 ...
+-->
 
 ## Management
 
 In order to manage Graph Insights snapshots, you can use the
 [`graph insights`](../../../automate/cmemc-command-line-interface/command-reference/graph/insights/index.md)
 command group of cmemc.
-With this command group, you can list, create, delete and inspect graph insight snapshots.
+With this command group, you can list, create, delete, and inspect graph insight snapshots.
 
 ## Automation
 
 To automate re-creation of Graph Insights snapshots, you can use the
 [Update Snapshots](../../../build/reference/customtask/cmem_plugin_graph_insights-Update.md)
 task in your workflows.
-This tasks allows for updating snapshots based on the specification of an
-affected graph.
+This task allows for updating snapshots based on the specification of an affected graph.