diff --git a/versions/1.0.0.md b/versions/1.0.0.md index 2f170e6..65d1b15 100644 --- a/versions/1.0.0.md +++ b/versions/1.0.0.md @@ -1,6 +1,6 @@ # Workflows Specification -#### Version 1.0.0 +## Version 1.0.0 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [BCP 14](https://tools.ietf.org/html/bcp14) [RFC2119](https://tools.ietf.org/html/rfc2119) [RFC8174](https://tools.ietf.org/html/rfc8174) when, and only when, they appear in all capitals, as shown here. @@ -16,11 +16,11 @@ The Workflows Specification can articulate these workflows in a human-readable a ## Table of Contents - [Workflows Specification](#workflows-specification) - - [Version 1.0.0](#version-100) + - [Version 1.0.0](#version-100) - [Introduction](#introduction) - [Table of Contents](#table-of-contents) - [Definitions](#definitions) - - [Workflows Description](#workflows-description) + - [Workflows Description](#workflows-description) - [Specification](#specification) - [Versions](#versions) - [Format](#format) @@ -55,20 +55,23 @@ The Workflows Specification can articulate these workflows in a human-readable a - [Component Object](#component-object) - [Fixed Fields](#fixed-fields-8) - [Component Object Example](#component-object-example) - - [Criterion Object](#criterion-object) - - [Fixed Fields](#fixed-fields-9) - - [Criterion Object Example](#criterion-object-example) - [Reference Object](#reference-object) - - [Fixed Fields](#fixed-fields-10) + - [Fixed Fields](#fixed-fields-9) - [Reference Object Example](#reference-object-example) + - [Criterion Object](#criterion-object) + - [Fixed Fields](#fixed-fields-10) + - [Criterion Object Example](#criterion-object-example) - [Runtime Expressions](#runtime-expressions) - [Specification Extensions](#specification-extensions) + - [Security Considerations](#security-considerations) + - [IANA Considerations](#iana-considerations) - [Appendix A: Revision History](#appendix-a-revision-history) + - [Appendix B: Contextual Scope Overview](#appendix-b-contextual-scope--access-for-inputs-and-outputs) ## Definitions -##### Workflows Description +### Workflows Description A self-contained document (or set of documents) which defines or describes API workflows (specific sequence of calls to achieve a particular goal in the context of an API definition). A Workflows Description (WD) uses and conforms to the Workflows Specification, and `MUST` contain a valid Workflows Specification version field (`workflowsSpec`), an [Info](#info-object) field, a `sourceDescriptions` field with at least one defined [Source](#source-description-object), and there `MUST` be at least one [Workflow](#workflow-object) defined in the `workflows` fixed field. ## Specification @@ -715,7 +718,7 @@ The runtime expression is defined by the following [ABNF](https://tools.ietf.org "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA ``` -##### Examples +##### Examples Source Location | example expression | notes ---|:---|:---|