amazon-ion / ion-docs

Source for the GitHub Pages for Ion.
https://amazon-ion.github.io/ion-docs/
Apache License 2.0
22 stars 22 forks source link

Remove `...` and `...+` cardinalities from the bulk of the document. #316

Closed toddjonker closed 4 months ago

toddjonker commented 4 months ago

Note that the binary encoding chapter still needs updating for this as well as the prior removal of grouped parameters.

Description of changes:

Updated the spec to remove the bespoke rest cardinalities; "rest parameter" is now an optional, implicit capability of final * and + parameters.

The "Macros by Example" chapter should probably be revisited and rearranged to account for this. Currently, it introduces ... long before cardinality as a concept, which at the time felt like an easier order to introduce things. Now that rest-parameters isn't a separate concept from cardinality, things would probably flow better introducing cardinality early on, then rest invocations later.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.