--- a/docs/Writerside/topics/compare.h.md	Wed Dec 31 15:25:30 2025 +0100
+++ b/docs/Writerside/topics/compare.h.md	Wed Dec 31 16:01:08 2025 +0100
@@ -8,7 +8,7 @@
 
 ## Examples
 
-In the following example we use `cx_cmp_int32` as compare function for a `CxList` of `int32_t` values.
+In the following example we use `cx_cmp_int32` as the compare function for a `CxList` of `int32_t` values.
 
 ```C
 CxList *list = cxArrayListCreate(
@@ -16,11 +16,12 @@
     sizeof(int32_t),    // the size of one element
     256                 // reseve space for 256 elements
 );
-cxSetCompareFunc(list, cx_cmp_int32); // the compare function for the elements
+// set the compare function for the elements
+cxSetCompareFunc(list, cx_cmp_int32);
 ```
 
 In the next example we simply want to compare two `double` values with rounding tolerance.
-Note how the use of the `cx_vcmp` flavour makes it unnecessary to store the literal in a variable just to be able to take an address.
+Note how the use of the `cx_vcmp` flavor makes it unnecessary to store the literal in a variable just to be able to take an address.
 ```C
 double x = ...