Skip to content

serverlessworkflow/specification

 
 

Repository files navigation

contributions welcome License

Serverless Workflow Specification

A specification that defines a vendor-neutral and declarative workflow language, targeting the serverless computing technology domain.

Serverless Workflow is hosted by the Cloud Native Computing Foundation (CNCF) and was approved as a Cloud Native Sandbox level project on July 14, 2020.

Table of Contents

Releases

Latest release Latest release branch Working branch
Core Specification
Serverless Workflow v0.6 0.6.x main
Additional Components
Java SDK 2.0.0.Final 2.0.x main
GO SDK v1.0.0 1.0.x main
VSCode Extension 1.6.0 main

SDKs

In addition to the documentation mentioned above, there is also a set of SDKs being developed and are part of the specification:

Being an open source community the Serverless Workflow team is open for new members as well open to their contributions. In order to ensure that an SDK is going to be supported and maintained, the Serverless Workflow community would like to ensure that:

  • Each SDK has active points of contact.
  • Each SDK supports the latest(N), and N-1, major releases of the specification.
  • Within the scope of a major release, only support for the latest minor version is needed.

Support for release candidates is not required, but strongly encouraged.

Tooling

In order to enhance developer experience with the specification, we also provide a Visual Studio Code extension. The sources of the extension are found here.

In order to ensure that the VSCode Extension is going to be supported and maintained, the Serverless Workflow community would like to ensure that is has a dedicated point of contact.

Community

We have a growing community working together to build a community-driven and vendor-neutral workflow ecosystem. Community contributions are welcome and much needed to foster project growth.

See here for the list of community members that have contributed to the specification.

To learn how to contribute to the specification reference the 'how to contribute' doc.

Communication

Code of Conduct

As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.

We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality.

See our full project Code of Conduct information here.

Meetings

The Serverless Workflow team meets weekly, every Monday at 10AM PT (USA Pacific).

Join from PC, Mac, Linux, iOS or Android via zoom

Or iPhone one-tap :

US: +16465588656,,3361029682#  or +16699006833,,3361029682#

Or Telephone:

Dial:
    US: +1 646 558 8656 (US Toll) or +1 669 900 6833 (US Toll)
    or +1 855 880 1246 (Toll Free) or +1 877 369 0926 (Toll Free)

Meeting ID: 336 102 9682

International numbers available: https://zoom.us/zoomconference?m=QpOqQYfTzY_Gbj9_8jPtsplp1pnVUKDr

NOTE: Please use *6 to mute/un-mute your phone during the call.

World Time Zone Converter: http:https://www.thetimezoneconverter.com/?t=9:00%20am&tz=San%20Francisco&

Meeting Minutes

The minutes from our calls are available here.

Periodically, the group may have in-person meetings that coincide with a major conference. Please see the meeting minutes for any future plans.

Repository Structure

Here is the outline of the repository to help navigate the specification documents:

File/folder Description
specification.md The main specification document
OWNERS Defines the current specification maintainers and approvers
LICENSE Specification License doc
MAINTAINERS.md Project Maintainers Info
GOVERNANCE.md Project Governance Info
contributing.md Documentation on how to contribute to the spec
code-of-conduct.md Defines the spec Code of Conduct
usecases Specification Use Cases
schema Contains all specification JSON Schemas
roadmap Specification Roadmap
references References used for specification docs
media Includes all images used in spec docs
extensions Information on spec extensions
examples Specification examples
comparisons Comparisons of Serverless Workflow with other workflow DSLs
community Contains info on the spec community