1.0.0-alpha1

[cdavernas]

Many thanks for submitting your Pull Request ❤️!

Please specify parts of this PR update:

• Specification
• Schema
• Examples
• Extensions
• Roadmap
• Use Cases
• Community
• TCK
• Other

Discussion or Issue link:
#843

What this PR does / why we need it:

The version 1.0.0-alpha1 is one of the most impacting release of the history of the Serverless Workflow DSL. It aims at both drastically simplify the DSL and at completing it with many new features.

It is intended to be the last release containing breaking changes before the Serverless Workflow DSL 1.0.0 can see the day.

What's new?

• Total refactor of grammar and semantics. See motivation.
  Addresses Rename data filter properties #672.
• Moved all descriptive properties into the document top level property. Adds a new (required) namespace DNS Label property.
  Addresses Add namespace property #838.
• Complex objects use maps instead of arrays, thus enabling more intelligible JSON pointers.
  Addresses Use maps instead of arrays for complex objects in the specification #831.
• All workflow components are now referencable. This allows getting rid of many cumbersome 'oneOf' definitions.
  Partially addresses Refactor external references #691.
• Merged the state and action concepts into task, getting rid of state nesting limitations. See tasks.
• Merged end and transition into flow directives.
  Addresses Group End and Transition properties #684.
• Got rid of the concept of compensation. Compensation can easily be designed by branching and/or chaining tasks.
• Support task nesting, thanks to composite tasks.
  Addresses Backward Compatibility: Parallel Branch does not support direct use of states definitions #413.
• Allows calling functions over HTTP, GRPC, OpenAPI and AsyncAPI. See calls.
  Addresses Rename action functionRef property #828.
• Allows running custom processes, using containers, shell commands, scripts or workflows. See processes.
• Supports both sequential and concurrent task execution modes. See execution strategy.
• Offers fault tolerance features, using try task to catch and handle errors raised during execution.
• Enables retrying on specific errors. See retry policy.
  Addresses Add multi retryRef to action #681 and Refactor retries #772.
• Supports timeouts, used to define a duration after which to raise a new timeout error, possibly faulting the task/workflow. See timeouts.
• Allows raising errors. See errors.
  Addresses Add means to throw an error #771.
• Added a serie of Gherkin features used for both conformance testing and Behavior Driven Design (BDD).
  Addresses Add stand-alone example resources #324.
• Supports concurrent event correlations.
  Addresses Rename eventDef correlation properties #679 and Find a way to name processed correlation keys #680.
• Enables extending and overriding the DSL, in a runtime agnostic and fully portable fashion, without writting a single line of code. See extensions.

[cdavernas]

This is a rebase of previous PR, which had gone critically wrong with signoffs.

[ricardozanini]

I think we should move on and handle the minors in another PR.

@cdavernas do you agree that we need to convert the examples into the new DSL and keep them here?

If so, we can open a new issue and do so.

[cdavernas]

@ricardozanini Not necessarilly, as they are given by the features. Those might be difficult to find for newcomers, though, intimidated by ctk, features, ...

But if you feel we should, then I'll get going before merging this one.

[ricardozanini]

@cdavernas I can send a PR on top of yours to fix the examples if you want, but tomorrow. Today my day is packed already :D

[cdavernas]

@ricardozanini I added the first example, to boostrap the PR you spoke about.

In the mean time, should I merge?

[ricardozanini]

@cdavernas sure, let's merge if you have the fup issues to handle the pending tasks we have. 👍

[cdavernas]

Created #850, #851 and #852 which are the main requirements, aside from all optimizations, corrections, fixes, etc.

[cdavernas]

Closes #843