Apply suggestions from code review

Co-authored-by: Martin Kouba <[email protected]>

docs/src/main/asciidoc/cdi-reference.adoc

@@ -1070,15 +1070,15 @@ public class NoopAsyncObserverExceptionHandler implements AsyncObserverException
 ----
 
 [[reactive_pitfalls]]
-== CDI Pitfalls with Reactive Programming
+== Pitfalls with Reactive Programming
 
 CDI is a purely synchronous framework.
 Its notion of asynchrony is very limited and based solely on thread pools and thread offloading.
 Therefore, there is a number of pitfalls when using CDI together with reactive programming.
 
 === Detecting When Blocking Is Allowed
 
-The `BlockingOperationControl.isBlockingAllowed()` method allows detecting when blocking is allowed.
+The `io.quarkus.runtime.BlockingOperationControl#isBlockingAllowed()` method can be used to detect whether blocking is allowed on the current thread.
 When it is not, and you need to perform a blocking operation, you have to offload it to another thread.
 The easiest way is to use the `Vertx.executeBlocking()` method: