/specification

Serverless Workflow Specification

Primary LanguageMakefileApache License 2.0Apache-2.0

contributions welcome License

Serverless Workflow Specification

A specification for defining declarative workflow models that orchestrate event-driven, serverless applications.

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 Working Draft
Core Specification:
Serverless Workflow v0.1 master
Additional Documentation:
Model JSON Schema v0.1 master

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.

Community

We have an growing community working together to build a dynamic serverless workflow ecosystem. Community contributions are welcome and much needed to foster specification growth.

To learn more about the specification community reference the community docs.

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 sub-group meets biweekly, every second Monday at 10AM PT (USA Pacific).

Join from PC, Mac, Linux, iOS or Android: https://zoom.us/my/cncfserverlesswg

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://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
community Contains info on the spec community