Configuring OpenAPI Services Endpoints improvements

[LuboTerifaj]

During #591, there were identified several issues that might need to be updated.

Section: https://sonataflow.org/serverlessworkflow/main/service-orchestration/configuring-openapi-services-endpoints.html

Issues

• There is missing reference to an example.

• Missing the description, why and how to configure Services Endpoints.

  • Why it is necessary to have it configured
  • Where it should be defined (application.properties)
  • How the property should be constructed (e.g.: quarkus.rest-client.stock_portfolio_svc_yaml.url=http://localhost:8282/)

• In the section, there is: "SonataFlow follows the strategy defined in the kogito.sw.operationIdStrategy property to generate the REST Client. The possible values of the kogito.sw.operationIdStrategy property include:"

  • Missing information, where can be those properties found.

Acceptance criteria

All issues above are resolved.