Apply suggestions from code review

Co-authored-by: Thomas Jaeckle <[email protected]>

Meetups/19/2024-10-14-minutes.md

@@ -1,6 +1,6 @@
 # Meeting Minutes
 
-:date: **Date:** 23 May 2024
+:date: **Date:** 14 Oct 2024
 
 ## Information
 
@@ -73,25 +73,25 @@ Thomas: we are from beyonnex.io a new IoT startup (younger than 3 years) we are
 
 Thomas: We have a B2B model and our customers are housing companies however residents use our devices as a services. No need to think about battery connectivity or maintenance.
 
-Thomas: the group started from the submetering devices to collect and allocate head/water consumptions among residents. We also offer backend and application services.
+Thomas: the group started from the submetering devices to collect and allocate heat/water consumptions among residents. We also offer backend and application services.
 
-Thomas: the devices are connected with M-Bus for remote reading for water, gas and electricity. Usually the readings are uni-directional. The readings are consumed from a Backend. We also support LoRaWan. With LoRa we are able to have a bi-directional communication. However, they have special interaction patterns because the device might be turned off to save battery.
+Thomas: the devices are connected with M-Bus for remote reading for water, gas and electricity. Those readings are always uni-directional. The readings are consumed from a Backend. We also support LoRaWan. With LoRa we are able to have a bi-directional communication. However, they have special interaction patterns because the device might be turned off to save battery.
 
 Thomas: We have to control and manage the device environment too. Where the device is installed, which consumer can control them?
 
 Thomas: That's why we have the need to model all these requirements with the concept of the digital twin.
 
 Thomas: we provide APIs for accessing the device data or sending commands. We can also abstract from protocols are connected with. Access control is managed by the digital twin too. Thanks to this model we can have high order digital twins that control and aggregates simple twins.
 
-Thomas: we are using Eclipse ditto, to provide the backbone for the whole system.
+Thomas: we are using Eclipse Ditto, to provide the backbone for the whole system.
 
 Thomas shows an example of a JSON representation (like a TD) for Eclipse Ditto.
 
 Thomas: you can use a set of APIs to obtain the data presented in the JSON Representation.
 
 Thomas: We use thing model as a why to define common affordances. Upon creation the model is used as a skeleton to create the JSON and for each Thing linked in the model it create the corresponding TD. Ditto will use TM to validate Thing modifications (updates to the structure of the Digital Model).
 
-Thomas shows how TM can help detect erroneous updates of TDs
+Thomas shows how TM can help detect erroneous updates of Ditto Things.
 
 Thomas: we are doing this because we want to be sure that the contracts are met which improve reliability. Plus it can provide helpful error messages.
 
@@ -103,11 +103,11 @@ Thomas: we create new thing models using IntelliJ, we applied semantic versionin
 
 Thomas: We built tooling around Thing Models. Writing is hard but Reading TMs it also hard. We create tooling to create OpenAPI definitions from TM and Ditto Endpoints. We integrate this tooling in our CI/CD pipeline
 
-Thomas: We create an Swagger UI automatically, it helps the readability. We have some basic code generation to help the deployment and the development of Thing Models. We used kotlin to create data classes from TMs. Everything is provided as Maven plugin so that yuo can integrate in your build workflow.
+Thomas: We create an Swagger UI automatically, it helps the readability. We have code generation based on the Thing Models to help mapping data to and from the right JSON format during development. We generate Kotlin data classes from TMs. Everything is provided as Maven plugin so that it can be integrated in the build workflow.
 
 Thomas: the DSL that we built for Kotlin is similar to write JSON but it does compile time checks. We also created a migration tooling to help managing updates of already existing TMs.
 
-Thomas: we use mainly WoT TMs for building digital twins, ditto ensure changes to twin always adhere to the TMs. At our company we continue to inventing tooling around in TMs and Ditto integration. We aim to make the generic tooling around Ditto and TMs Open Source soon.
+Thomas: we use mainly WoT TMs for building digital twins, Ditto ensures changes to twin always adhere to the TMs. At our company we continue to inventing tooling around in TMs and Ditto integration. We aim to make the generic tooling around Ditto and TMs Open Source soon.
 
 ### Questions
 
@@ -135,15 +135,15 @@ Thomas S: We struggle to have this feature in Web of Things, it would be conveni
 
 Thomas: Currently, there is no way to model it. But we can create a context extension to describe this.
 
-Ege: want to mean for desirable properties?
+Ege: want to mean for desired properties?
 
 Thomas: Yes basically they describe the user will to have the device in a precise state.
 
 Wilfried: Former colleague, thank you for the presentation. It is usable in a industrial scenario? or it is just for your company?
 
 Thomas: no and yes.
 
-Wilfried: Are the desirable properties out of the box available in your platform?
+Wilfried: Are the desired properties out of the box available in your platform?
 
 Thomas: not yet.
 
@@ -189,7 +189,7 @@ Thomas: correct, our users are using Swagger because it is easier to digest. We
 
 Ege: What are the policies? There are also w3c standards about it
 
-Thomas: You can always go to the eclipse DITTO documentation to learn more about it.
+Thomas: You can always go to the Eclipse Ditto documentation to learn more about it.
 
 Cris: are using any of information from Thing Models to create UI elements for the users?