Improve Reactive Routes documentation for ending the response

docs/src/main/asciidoc/reactive-routes.adoc

@@ -200,6 +200,9 @@ A route method must be a non-private non-static method of a CDI bean.
 If the annotated method returns `void` then it has to accept at least one argument - see the supported types below. 
 If the annotated method does not return `void` then the arguments are optional.
 
+NOTE: Methods that return `void` must __end__ the response or the HTTP request to this route will never end.
+Some methods of `RoutingExchange` do it for you, others not and you must call the `end()` method of the response by yourself, please refer to its JavaDoc for more information.
+
 A route method can accept arguments of the following types: 
 
 * `io.vertx.ext.web.RoutingContext`

extensions/vertx-web/runtime/src/main/java/io/quarkus/vertx/web/RoutingExchange.java

@@ -11,8 +11,14 @@
  */
 public interface RoutingExchange {
 
+    /**
+     * @return the underlying Vert.x routing context.
+     */
     RoutingContext context();
 
+    /**
+     * @return the HTTP request object
+     */
     default HttpServerRequest request() {
         return context().request();
     }
@@ -29,30 +35,56 @@ default Optional<String> getParam(String paramName) {
 
     /**
      * 
-     * @param paramName
+     * @param headerName
      * @return the first header value with the specified name
      * @see HttpServerRequest#getHeader(CharSequence)
      */
     default Optional<String> getHeader(CharSequence headerName) {
         return Optional.ofNullable(request().getHeader(headerName));
     }
 
+    /**
+     * @return the HTTP response object
+     */
     default HttpServerResponse response() {
         return context().response();
     }
 
+    /**
+     * Set the response status code to 200 and return the response.
+     * You must call <code>HttpServerResponse.end()</code> afterwards to end the response.
+     * 
+     * @return the HTTP response object
+     */
     default HttpServerResponse ok() {
         return response().setStatusCode(200);
     }
 
+    /**
+     * Set the response status code to 200, write a chunk of data to the response then ends it.
+     * 
+     * @param chunk
+     */
     default void ok(String chunk) {
         ok().end(chunk);
     }
 
+    /**
+     * Set the response status code to 200 and return the response.
+     * You must call <code>HttpServerResponse.end()</code> afterwards to end the response.
+     * 
+     * @return the HTTP response object
+     */
     default HttpServerResponse serverError() {
         return response().setStatusCode(500);
     }
 
+    /**
+     * Set the response status code to 200 and return the response.
+     * You must call <code>HttpServerResponse.end()</code> afterwards to end the response.
+     * 
+     * @return the HTTP response object
+     */
     default HttpServerResponse notFound() {
         return response().setStatusCode(404);
     }