gibson042 / serverlessworkflow-specification

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
• SDKs
• Tooling
• Community
  • Communication
  • Code of Conduct
  • Meetings
  • Meeting Minutes
• Repository Structure

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:

• Go
• Java

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.

If you have any copyright questions when contributing to a CNCF project like this one, reference the Ownership of Copyrights in CNCF Project Contributions doc.

Communication

• Community Slack Channel: https://slack.cncf.io/ - #serverless-workflow
• Weekly project meetings
• Project Maintainers Email: cncf-serverlessws-maintainers
• Serverless WG Email: cncf-wg-serverless
• Serverless WG Subscription: https://lists.cncf.io/g/cncf-wg-serverless

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

• CNCF public events calendar

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: [phone],,3361029682#  or [phone],,3361029682#

Or Telephone:

Dial:
    US: [phone] (US Toll) or [phone] (US Toll)
    or [phone] (Toll Free) or [phone] (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://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