kdl-org / kdl

the kdl document language specifications
https://kdl.dev
Other
1.09k stars 61 forks source link

Inconsistent wording between Annotations, Property Keys, and Node Names #264

Closed Lucretiel closed 1 year ago

Lucretiel commented 2 years ago

Node names and Property keys are described as:

...a legal Identifier, or a quoted String.

Whereas annotations are described as:

with a single Identifier in it.

Generally throughout the spec, Identifiers, Strings, and Raw strings are distinguished, and union cases simply name all the possible types. As a generalization of this specific issue, I'd like to propose the following hierarchy (used by kaydle's parser) to simplify the naming of strings throughout the spec: