initial review with aw.

Author: rpietzsch

docs/build/mapping-creator/index.md

@@ -7,16 +7,24 @@ tags:
 ---
 # Mapping Creator
 
-??? info "Configuration"
+## Configuration
+
+!!! info "Configuration"
 
     See [Mapping Creator and LLM Configuration](../../deploy-and-configure/configuration/dataintegration/index.md#mapping-creator-and-llm-configuration) to learn how to enable and configure this feature.
 
-!!! question "Inline help"
+The Mapping Creator need to configured in order to be activated and used.
+Furthermore, for best experience it requires an LLM provider configuration, see the link in the info box for the details.
+
+## Usage
 
-    ![Inline Help](mapping-creator-help.png){ class="bordered" width="20%" align=right padding=40 }
+!!! question "Help"
 
-    Access inline help and a feature tour via the help menu :eccenca-item-question:.
+    ![Help](mapping-creator-help.png){ class="bordered" width="20%" align=right padding=40 }
 
+    Access help and a feature tour via the help menu :eccenca-item-question:.
+
+**TODO:** describe how to get there in the first place!!! BUILD > Project > [ Workflow > ] Transformation > Mapping Creator
 
 Use the Mapping Creator to connect your data to semantic models.
 Using visual tools, drag-and-drop, and suggestions, you’ll create mappings between your source data and knowledge graph classes as well as their properties.
@@ -29,21 +37,32 @@ The Mapping Creator is split into three parts:
 -   The right sidebar shows the target schema
 -   Mappings between elements in the source schema and elements in the target schema.
 
+**TODO**: rename _sidebar_ and describe the actual _sidebars_ properly (left: schema information, right: see below (Edit saved mapping rule))
+
 You can move, connect or disconnect, and inspect each element visually.
 
-## Manual creation
+### Color Legend
+
+**TODO:** show the color legend here, too
+
+<figure markdown="span">
+    ![Color Legend](mapping-creator-color-legend.png){ class="bordered" }
+    <figcaption>Color Legend Image Caption</figcaption>
+</figure>
+
+### Manual creation
 
 Every mapping begins by selecting or creating a target class.
 This defines where your data will be be mapped in the knowledge graph.
 
-### Add properties
+#### 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).
 The following two options exist to add properties.
 
-#### During class selection
+##### During class selection
 
 ![Properties option in the class selection dialog](mapping-creator-class-selection.png){ class="bordered" width="80%" }
 
@@ -55,7 +74,7 @@ In the _add target class_ dialog you may select different kind of properties:
 
 The property preview helps to confirm your choice.
 
-#### By adding a property from your vocabularies
+##### By adding a property from your vocabularies
 
 ![Adding a property from your vocabulary](mapping-creator-property-selection.png){ class="bordered" width="80%" }
 
@@ -64,28 +83,28 @@ The _add property from vocabularies_ dialog allows to search and select a proper
 -   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
 
-### Create direct mappings
+#### Create direct mappings
 
 Drag from a property in your source data to a class or property in the canvas to create your mapping.
 This is helpful when smart suggestions are not sufficient.
 
-### Edit saved mapping rule
+#### Edit saved mapping rule
 
 ![Editing a saved rule](mapping-creator-edit-rule.png){ class="bordered" width="60%" }
 
 Click on an already saved target element to show more details.
 With the :eccenca-item-edit: Pencil icon you can edit the mapping rule and rename elements, or adjust configurations.
 Advanced users can refine transformation logic here.
 
-## Smart suggestions
+### Smart suggestions
 
 !!! info
     Note that this feature is only available if a Large Language Model is configured.
 
 Click the :eccenca-application-ai-suggestion: Magic Wand to automatically generate mapping suggestions based on your data and the selected class.
 Accept (:octicons-thumbsup-16:) or reject (:octicons-thumbsdown-16:) each suggestion as needed.
 
-### Class Suggestions
+#### Class Suggestions
 
 ![Smart Class Suggestions](mapping-creator-class-suggestion.png){ class="bordered" }
 
@@ -94,7 +113,7 @@ Alternatively, you can search for classes manually by typing text into the searc
 
 Hover over the wand icon for each suggestion to understand why this class has been recommended.
 
-### Property Suggestions
+#### Property Suggestions
 
 Property suggestions are generated that map your source data to elements of the selected target vocabularies.
 You can accept (:octicons-thumbsup-16:) or reject (:octicons-thumbsdown-16:) each suggestion.