[#1250] Fix review findings in documentation

Author: elBoberido

doc/user-documentation/how-to-switch-vocabulary-types-for-iceoryx2-cxx.md

@@ -32,12 +32,13 @@ In addition to use the `std::optional` and `std::expected` with the iceoryx2 C++
 bindings, it is also possible to use custom implementations of these types.
 
 > [!NOTE]
-> The custom implementations must be API compatible with the STL counterparts.
+> The custom implementations must be API compatible with the STL counterparts
+> and must not depend on iceoryx2-bb-cxx to avoid a circular dependency!
 
 To integrate the custom vocabulary types into iceoryx2, a CMake target for the
 `Expected` and `Optional` must be created.
 
-Please have a look at the
+Take a look at the
 [custom-vocabulary-types](../../examples/cxx/custom-vocabulary-types) example
 as a blueprint to create a CMake package with the required files.
 

examples/cxx/custom_vocabulary_types/README.md

@@ -15,9 +15,9 @@ cmake --build target/ff/cc/custom_vocabulary_types
 cmake --install target/ff/cc/custom_vocabulary_types --prefix target/ff/cc/install
 ```
 
-Now, iceoryx2 needs to be build with the custom vocabulary types:
+Now, iceoryx2 needs to be built with the custom vocabulary types:
 
-```
+```console
 cargo build --package iceoryx2-ffi-c
 cmake -S . \
       -B target/ff/cc/build \