martinweiler commented on code in PR #2002:
URL: 
https://github.com/apache/incubator-kie-kogito-apps/pull/2002#discussion_r1503144520


##########
data-index/README.md:
##########
@@ -1,4 +1,85 @@
-## Kogito Data Index Service
+# Kogito Data Index Service
+
+Data Index is a subsystem/component responsible to store a snapshot of the 
last state of the process instance state. 
+
+The system supports two different types of deployment:
+*   Compact Architecture: as component deployed within the application
+*   Distributed Architecture: as component deployed independently as service
+
+Due to the nature of the system it support different types of storage
+
+*   postgresql
+*   infinispan
+*   mongodb
+*   jpa
+
+At present for compact configuration it only support quarkus runtime. For 
distributed supports both runtimes quarkus and springboot.
+
+
+## Compact architecture
+
+The next dependency is added for quarkus and being able to use in-vm transport 
tier
+The next dependency is used to specify the storage of the data index and the 
transport tier at the same time.
+
+       
+
+    <dependency>
+      <groupId>org.kie</groupId>
+      
<artifactId>kogito-addons-quarkus-data-index-persistence-postgresql</artifactId>
+    </dependency>
+
+       
+
+As this dependency will include the storage as well and the in-vm transport.
+
+       
+
+    <dependency>
+      <groupId>org.kie</groupId>
+      
<artifactId>kogito-addons-quarkus-data-index-persistence-<storage></artifactId>
+    </dependency>
+
+
+where storage can be:
+*   infinispan
+*   mongodb
+*   postgresql
+
+Current system

Review Comment:
   Maybe it would help to add a sentence to describe the diagram, eg:
   
   ```
   ## How data index works
   
   ![data-index](docs/data-index.png "Data Index")
   
   The concepts to understand the above picture are:
   *   Transport: the medium used to transfer events between the runtime and 
the data index service. The transport is http in distributed environments, or 
in-vm for compact architecture.
   *   Storage: the persistence tier of the data index component.
   *   Data index: the main component responsible for creating/updating the 
data index, and for providing query capabilities.
   ```
   



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to