CAMEL-23013: Enhance the OpenAPI component's description

[gnodet]

Summary

• Update the rest-openapi component description to mention both producer and consumer capabilities
• Previous description only mentioned calling REST services (producer), but the component also supports exposing REST services (consumer)
• Updated description: "To call and expose REST services using OpenAPI specification as contract."

Test plan

• Verified description updated in source (RestOpenApiEndpoint.java)
• Verified description updated in docs (rest-openapi-component.adoc)
• Verified generated metadata files updated (rest-openapi.json, DSL factories)

[github-actions]

🌟 Thank you for your contribution to the Apache Camel project! 🌟
🤖 CI automation will test this PR automatically.

🐫 Apache Camel Committers, please review the following items:

• First-time contributors require MANUAL approval for the GitHub Actions to run
• You can use the command /component-test (camel-)component-name1 (camel-)component-name2.. to request a test from the test bot although they are normally detected and executed by CI.
• You can label PRs using build-all, build-dependents, skip-tests and test-dependents to fine-tune the checks executed by this PR.
• Build and test logs are available in the summary page. Only Apache Camel committers have access to the summary.

⚠️ Be careful when sharing logs. Review their contents before sharing them publicly.

[github-actions]

🧪 CI tested the following changed modules:

• catalog/camel-catalog
• components/camel-rest-openapi
• dsl/camel-componentdsl
• dsl/camel-endpointdsl

All tested modules (88 modules)

• Camel :: All Components Sync point
• Camel :: All Components Sync point [pom]
• Camel :: Assembly
• Camel :: Assembly [pom]
• Camel :: Catalog :: CSimple Maven Plugin (deprecated) [maven-plugin]
• Camel :: Catalog :: CSimple Maven Plugin (deprecated) SUCCESS [ 1.360 s]
• Camel :: Catalog :: Camel Catalog
• Camel :: Catalog :: Camel Catalog [jar]
• Camel :: Catalog :: Camel Report Maven Plugin
• Camel :: Catalog :: Camel Report Maven Plugin [maven-plugin]
• Camel :: Catalog :: Camel Route Parser
• Camel :: Catalog :: Camel Route Parser [jar]
• Camel :: Catalog :: Console
• Camel :: Catalog :: Console [jar]
• Camel :: Catalog :: Dummy Component
• Camel :: Catalog :: Dummy Component [jar]
• Camel :: Catalog :: Lucene (deprecated)
• Camel :: Catalog :: Lucene (deprecated) [jar]
• Camel :: Catalog :: Maven
• Camel :: Catalog :: Maven [jar]
• Camel :: Catalog :: Suggest
• Camel :: Catalog :: Suggest [jar]
• Camel :: Component DSL
• Camel :: Component DSL [jar]
• Camel :: Coverage
• Camel :: Coverage [pom]
• Camel :: Docs
• Camel :: Docs [pom]
• Camel :: Endpoint DSL
• Camel :: Endpoint DSL [jar]
• Camel :: Endpoint DSL :: Support
• Camel :: Endpoint DSL :: Support [jar]
• Camel :: Integration Tests
• Camel :: Integration Tests [jar]
• Camel :: JBang :: Core
• Camel :: JBang :: Core [jar]
• Camel :: JBang :: Integration tests
• Camel :: JBang :: Integration tests [jar]
• Camel :: JBang :: MCP
• Camel :: JBang :: MCP [jar]
• Camel :: JBang :: Main
• Camel :: JBang :: Main [jar]
• Camel :: JBang :: Plugin :: Edit
• Camel :: JBang :: Plugin :: Edit [jar]
• Camel :: JBang :: Plugin :: Generate
• Camel :: JBang :: Plugin :: Generate [jar]
• Camel :: JBang :: Plugin :: Kubernetes
• Camel :: JBang :: Plugin :: Kubernetes [jar]
• Camel :: JBang :: Plugin :: Route Parser
• Camel :: JBang :: Plugin :: Route Parser [jar]
• Camel :: JBang :: Plugin :: Testing
• Camel :: JBang :: Plugin :: Testing [jar]
• Camel :: JBang :: Plugin :: Validate
• Camel :: JBang :: Plugin :: Validate [jar]
• Camel :: JSon Path
• Camel :: JSon Path [jar]
• Camel :: Kamelet Main
• Camel :: Kamelet Main [jar]
• Camel :: Knative HTTP
• Camel :: Knative HTTP [jar]
• Camel :: Launcher
• Camel :: Launcher [jar]
• Camel :: Launcher :: Container
• Camel :: Launcher :: Container [pom]
• Camel :: Micrometer :: Prometheus
• Camel :: Micrometer :: Prometheus [jar]
• Camel :: OAuth
• Camel :: OAuth [jar]
• Camel :: Observability Services
• Camel :: Observability Services [jar]
• Camel :: OpenAPI :: Validator
• Camel :: OpenAPI :: Validator [jar]
• Camel :: Platform HTTP :: Main
• Camel :: Platform HTTP :: Main [jar]
• Camel :: Platform HTTP :: Vert.x
• Camel :: Platform HTTP :: Vert.x [jar]
• Camel :: REST OpenApi
• Camel :: REST OpenApi [jar]
• Camel :: YAML DSL
• Camel :: YAML DSL [jar]
• Camel :: YAML DSL :: Deserializers
• Camel :: YAML DSL :: Deserializers [jar]
• Camel :: YAML DSL :: Maven Plugins
• Camel :: YAML DSL :: Maven Plugins [maven-plugin]
• Camel :: YAML DSL :: Validator
• Camel :: YAML DSL :: Validator [jar]
• Camel :: YAML DSL :: Validator Maven Plugin
• Camel :: YAML DSL :: Validator Maven Plugin [maven-plugin]