[camel] 04/04: CAMEL-17819: camel-jbang - Can we support --opena-api like camel-k have

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git

commit 37022a8ff3c1895aeea8c9de5529913a23b6b7c6
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Wed May 4 12:55:50 2022 +0200

    CAMEL-17819: camel-jbang - Can we support --opena-api like camel-k have
---
 docs/user-manual/modules/ROOT/pages/camel-jbang.adoc | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc b/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
index ffbd3e233fa..52a9b34f6d4 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
@@ -323,6 +323,18 @@ Listening for transport dt_socket at address: 4004
 
 As you can see the default listening port is 4004 but can be configured as described in https://www.jbang.dev/documentation/guide/latest/debugging.html[JBang Debugging].
 
+== Open API
+
+Camel JBang allows to quickly expose an Open API service using _contract first_ apprach,
+where you have an existing OpenAPI specification file.
+
+Then Camel JBang is able to bridge each API endpoints from the OpenAPI specification to
+a Camel route with the naming convention `direct:<operationId>`.
+
+This make it quick to implement a Camel route for a given operation.
+
+See the https://github.com/apache/camel-kamelets-examples/tree/main/jbang/open-api)[open-api example] for more details.
+
 == Packaging
 
 The Camel JBang application can be packaged as a standalone _uber-jar_ without the need for JBang to run the application.