spec_history.md

June 8, 2018 · View on GitHub

Revision History

VersionDateNotes
0.8.12016-11-03
  • Initial public point draft
0.8.22016-12-12
  • Begin adding use cases, examples to all sections.
0.8.32017-02-02
  • Add more use cases, examples
  • Add description of "$" (dollar) notation
0.8.42017-04-18
  • Support JSON parameter type;
    Clarify use of Parameter single-line grammar and inferred types.
  • Add support for API Gateway mappings.
  • Add support for Web Actions
0.8.52017-04-21
  • Add support for “dependencies”, that is allow automatic deployment of other OpenWhisk packages (from GitHub) that the current package declares as a dependency.
0.8.62017-07-25
  • Clarified requirements for $ dollar notation.
  • Updated conceptual Manifest/Deployment File processing images.
0.8.72017-08-24
  • Added explicit Application entity and grammar.
  • Added API listing to Package entity.
  • Cleaned up pseudo-grammar which contained various uses of credentials in places not intended.
  • Fixed Polygon Tracking example (indentation incorrect).
0.8.82017-08-29
  • Created a simplified API entity (i.e., “api”) grammar that allows multiple sets of named APIs for the same basepath.
  • Acknowledge PHP as supported runtime (kind).
  • Added “sequences” entity as a convenient way to declare action sequences in the manifest. Updated supported runtime values.
0.8.92017-09-22
  • Clarified “version” key requirements for Package (required) and Action (optional); removed from shared entity schema.
0.8.9.12017-09-29
  • Made “license” key optional for package.
  • keyword “package” (singular) and “packages” (plural) both allowed.
  • Adjusted use case examples to reflect these changes.
  • Rework of schema use cases into full, step-by-step examples.
  • Spellcheck, fixed bugs, update examples to match web-based version.
0.8.9.12017-10-06
  • Added grammar and example for concatenating string values on input parameters using environment variables.
0.9.02017-11-23
  • Identified new user scenarios including: clean, refresh, sync, pre/post processing
0.9.12017-11-30
  • Clarified “runtime” field on Action is equivalent to “kind” parameter used on the Apache OpenWhisk CLI for Actions.
  • Added “project” key as an synonym name for “application”.” key, moving application to become deprecated. Project name made required.
  • Support “public” (i.e., publish) key on Package.
  • Documented support for the “raw-http” annotation under Action.
  • Documented support for the “final” annotation under Action.
  • Documented support for the “main” field under Action.
  • Dollar Notation section becomes Interpolation / updates:
    • Supported beyond Parameter values
    • Package names can be interpolated
    • Annotations values can be interpolated
    • Multiple replacements supported in same value
  • Usage scenarios 6-8 added, i.e., Clean, Project Sync, Tool chain support.
0.9.22018-02-05
  • Fixed and clarified the allowed values for “web-export” on Action.
  • Clarified use of “final” on Action.
  • Added support (planned) for “web-custom-options” and “require-whisk-auth.” flags on Actions (annotations)
  • Deprecate ‘application’ and ‘package’ completely (no longer supported)
0.9.2.22018-04-04
  • Allow “web” key as an overload for “web-export” key for to indicate Web Actions.
  • Added Web Sequences, specify a sequence is a Web Action.
  • Added support for Conductor Actions, to align with OpenWhisk CLI support.
  • Added “docker” and “native” binary support under Action.
  • Added in-line “code” support under Action.
  • Support $$, double-dollar notation for string literals on parameter values.
  • Added support for “default” package (allowing all entities to be assigned directly under the user’s default namespace), that is not requiring a package name to be created.

Index