clarify ordering stuff

This commit is contained in:
Kat Marchán 2021-08-31 23:00:39 -07:00
parent e4ad12ecfd
commit 0a3e498e16
No known key found for this signature in database
GPG Key ID: AEB529C08A3C7E9E
1 changed files with 3 additions and 1 deletions

View File

@ -15,7 +15,9 @@ following rules:
* All comments removed
* Extra empty lines removed except for a newline after the last node
* All nodes should be reformatted without escaped newlines
* Node fields should be `identifier <args in same order> <properties in alpha order by key> <children if non-empty>`
* Node fields should be `identifier <values> <properties> <children only if non-empty>`
* All values and all children must be in the same order as they were defined.
* Properties must be in _alphabetical order_ and separated by a single space.
* All strings must be represented as regular strings, with appropriate escapes
for invalid bare characters. That means that raw strings must be converted
to plain strings, and escaped.