Merge branch 'main' into 271-properly-document-mapping-either-to-json…

…-payload

documentation/modules/appendix/pages/best-practices.adoc

@@ -84,9 +84,16 @@ range, while a Property such as `numberOfProducedItems` is not logically limited
 [[choosing-a-unit]]
 == Choosing a Unit
 
-When trying to refer to a physical unit, please see the
-xref:appendix:unitcatalog.adoc[Unit Catalog]. When searching for the unit,
-remember that the unit catalog uses British English.
+When trying to refer to a physical unit, please see the xref:appendix:unitcatalog.adoc[Unit
+Catalog]. When searching for the unit, remember that the unit catalog uses British English, e.g.,
+_metre_ instead of _meter_.
+
+TIP: If you're modeling quantities for which both the metric system and the imperial system provide
+units, such as meter vs feet, it is always recommended to use the metric system (preferably SI units
+like meter or others like kilometer if more common in the domain) – unless there are specific
+reasons to create the model differently. In any case it is strongly discouraged to add multiple
+Properties in the same scope representing the same value only using different units due to the
+inherent complexity.
 
 [[choosing-a-characteristic]]
 == Choosing a Characteristic