ion-docs
ion-docs copied to clipboard
Source for the GitHub Pages for Ion.
DO NOT MERGE! For illustration only. I updated most (if not all) of the examples in the spec to illustrate how separators work as a replacement for argument groups. I've...
There is some ambiguity between the spoken-language spec and the Text Grammar about whether comment starts delimit the end of "numeric_entities" and "sexp_keyword_entities." Consider the below: ``` 2004T/* comment after...
One fundamental capability of Ion 1.0 is that any document can be transcoded between text and binary without access to any shared symbol tables, even without evaluating local symbol table...
Many sections are hand-wavy about this since it's not yet determined in detail.
I forgot how to use terms I defined many years ago. The new content misuses "local symbol table" in place of "current symbol table". The legacy spec is clear that...
Update signatures to not include types or s-expressions around variables.
* In a macro signature, macro parameters are contained in a s-expression rather than a list * ~~Cardinality of parameters is no longer supported~~ * Parameter types are no longer...
The spec does not say how individual timestamp fields are indexed. A reader could reasonably conclude they are all zero-indexed, but it's common for `month` and `day` to be 1-indexed...
For example, short-form timestamps can have unused bits. (The high bit in a `year` timestamp, the high five bits in a `month` timestamp, etc.) A writer could reasonably decide to...
Our int encodings (including primitives) have switched to little endian in Ion 1.1 for a performance boost. Floats also rely on the CPU's native endianness, but the current version of...