doc: update openapi doc to mention support on script routes

Author: jknack

docs/asciidoc/modules/openapi.adoc

@@ -195,10 +195,80 @@ properties filter routes by their path pattern. The filter is a regular expressi
 
 === JavaDoc comments
 
-Parsing of JavaDoc comment is supported on Java MVC/Controller.
+JavaDoc comments are supported on Java in script and MVC routes.
 
-.Java
-[source,java]
+.Script routes
+[source,java, role="primary"]
+----
+
+/**
+* My Library.
+* @version 5.4.1
+* @tag Books. All about books.
+* @server.url https://books.api.com
+* @server.description Production
+* @x-logo https://my.api.com/logo.png
+*/
+public class App extends Jooby {
+  {
+    install(new OpenAPIModule());
+   
+    /*
+     * Books operations.
+     * @tag Books  
+    */
+    path("/api/books", () -> {
+        /*
+         * Query and filter books.
+         * 
+         * @param query Book filter.
+         * @return List of matching books.
+         * @operationId query
+         */
+        get("/", ctx -> {
+         var query = ctx.query(BookQuery.class);  
+        });
+        /*
+         * Find a book by ISBN.
+         * @param isbn ISBN code.
+         * @return A book.
+         * @throws BookNotFoundException When a book doesn't exist. <code>404</code> 
+         * @operationId bookByIsbn
+         */
+        get("/{isbn}", ctx -> {
+         var query = ctx.query(BookQuery.class);  
+        });
+    });
+    
+  }
+}
+
+/**
+ * Book query.
+ * 
+ * @type Book type.
+ * @aga Book age.
+ */
+public record BookQuery(BookType type, int age) {}
+
+/**
+ * Books can be broadly categorized into fiction and non-fiction
+ */
+public enum BookType {
+  /**
+  * Fiction includes genres like fantasy, science fiction, romance, and mystery.
+  */
+  Fiction,
+  /**
+  * Non-fiction encompasses genres like history, biography, and self-help.
+  */
+  NonFiction
+}
+
+----
+
+.MVC routes
+[source,java, role="secondary"]
 ----
 
 /**
@@ -209,7 +279,7 @@ Parsing of JavaDoc comment is supported on Java MVC/Controller.
 * @server.description Production
 * @x-logo https://my.api.com/logo.png
 */
-public class App {
+public class App extends Jooby {
   {
     mvc(new Books_());
     install(new OpenAPIModule());
@@ -344,6 +414,12 @@ Whitespaces (including new lines) are ignored. To introduce a new line, you must
 |[x]
 |Shortcut for previous `@tag.name` and `@tag.description`. The tag name is everything before `.`
 
+|@operationId <name>
+|
+|
+|[x]
+|Defined the operationId, useful for script routes.
+
 |@param <name>
 |
 |
@@ -364,14 +440,12 @@ Whitespaces (including new lines) are ignored. To introduce a new line, you must
 
 |===
 
-This feature is only available for Java MVC/controller routes. There are plans to support lambda
-routes on Java. Kotlin source code is not supported.
+This feature is only available for Java routes. Kotlin source code is not supported.
 
 
 === Annotations
 
-To produce a better documentation, this plugin depends on some OpenAPI annotations. To use them, you
-need to add a dependency to your project:
+Optionally this plugin depends on some OpenAPI annotations. To use them, you need to add a dependency to your project:
 
 [dependency, artifactId="swagger-annotations"]
 .
@@ -430,7 +504,7 @@ fun findPetById(ctx: Context) : Pet {
 ----
 
 The OpenAPI annotations complement the openAPI byte code parser by adding documentation
-or being more specific about a operation, parameter, response type, response status, etc.
+or being more specific about an operation, parameter, response type, response status, etc.
 
 Annotations works as documentation but also as a way to override what was generated by the byte
 code parser.