diff --git a/docs/users_guide/framework_basics/dimensionless_quantities.md b/docs/users_guide/framework_basics/dimensionless_quantities.md
index 3ad4dd2b..0ef90213 100644
--- a/docs/users_guide/framework_basics/dimensionless_quantities.md
+++ b/docs/users_guide/framework_basics/dimensionless_quantities.md
@@ -256,20 +256,20 @@ Angular quantities are not the only ones with such a "strange" behavior. Another
is a _storage capacity_ quantity specified in IEC-80000-13 that again allows expressing it in both
`one` and `bit` units.
-Those cases make dimensionless quantities an exceptional tree in the library. This is the only
-[quantity hierarchy](../../appendix/glossary.md#quantity-hierarchy) that contains more than one
-[quantity kind](../../appendix/glossary.md#kind) in its tree:
+Those cases make dimensionless quantities an exceptional tree in the library. This
+[quantity hierarchy](../../appendix/glossary.md#quantity-hierarchy) contains more than one
+[quantity kind](../../appendix/glossary.md#kind) and more than one unit in its tree:
```mermaid
flowchart TD
dimensionless["dimensionless
[one]"]
dimensionless --- rotation["rotation"]
- dimensionless --- efficiency["efficiency"]
- dimensionless --- angular_measure["angular_measure
[rad]"]
- angular_measure --- rotational_displacement["rotational_displacement"]
+ dimensionless --- thermodynamic_efficiency["thermodynamic_efficiency
(work / heat)"]
+ dimensionless --- angular_measure["angular_measure
(arc_length / radius)
[rad]"]
+ angular_measure --- rotational_displacement["rotational_displacement
(path_length / radius)"]
angular_measure --- phase_angle["phase_angle"]
- dimensionless --- solid_angular_measure["solid_angular_measure
[sr]"]
- dimensionless --- drag_factor["drag_factor"]
+ dimensionless --- solid_angular_measure["solid_angular_measure
(area / pow<2>(radius))
[sr]"]
+ dimensionless --- drag_factor["drag_factor
(drag_force / (mass_density * pow<2>(speed) * area))"]
dimensionless --- storage_capacity["storage_capacity
[bit]"] --- equivalent_binary_storage_capacity["equivalent_binary_storage_capacity"]
dimensionless --- ...
```
diff --git a/docs/users_guide/framework_basics/systems_of_quantities.md b/docs/users_guide/framework_basics/systems_of_quantities.md
index ec177da9..3c24801a 100644
--- a/docs/users_guide/framework_basics/systems_of_quantities.md
+++ b/docs/users_guide/framework_basics/systems_of_quantities.md
@@ -296,7 +296,7 @@ sometimes not obvious what such a tree should look like. Also, ISO explicitly st
The division of ‘quantity’ according to ‘kind of quantity’ is, to some extent, arbitrary.
-The below presents some arbitrary hierarchy of derived quantities of kind energy:
+The below presents some arbitrary hierarchy of derived quantities of kind _energy_:
```mermaid
flowchart TD
@@ -365,7 +365,7 @@ quantities of the same kind. Such quantities have not only the same dimension bu
can be expressed in the same units.
To annotate a quantity to represent its kind (and not just a hierarchy tree's root quantity)
-we introduced a `kind_of<>` specifier. For example, to express any quantity of length, we need
+we introduced a `kind_of<>` specifier. For example, to express any quantity of _length_, we need
to type `kind_of`.
!!! important