From ee47ddba383689976065cbdb8942e14bcf0c19d7 Mon Sep 17 00:00:00 2001 From: Kevin Longe <273747162+kvlonge@users.noreply.github.com> Date: Sat, 14 Nov 2026 03:17:16 +0000 Subject: [PATCH] docs(syntax-coverage): list the known gaps of the Snowflake form review with their form counts --- coverage/syntax/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/coverage/syntax/README.md b/coverage/syntax/README.md index cce5ce151..9dc7eae8d 100644 --- a/coverage/syntax/README.md +++ b/coverage/syntax/README.md @@ -149,3 +149,18 @@ collision the heading is appended, then a number. (TIMESTAMP_LTZ/NTZ/TZ) is one form with each spelling an alternative. - The `ddl`/`security_admin` split is by title words (users, roles, policies, integrations, accounts, grants, shares, ...); it is a reporting split, not part of a form's identity. +- Known gaps under review brief version 1, with the forms each affects: + - A name part that `a..b` leaves out is serialized as the empty name `""`, which criterion (d) + does not accept: 297 forms were rejected on it, 256 of which stay verified on earlier reviews + of the same tree. + - A repeated list item (`[ , ... ]`) has no case of its own for its second item: 461 + verified and 203 unverified forms repeat one. + - MERGE keeps its `THEN` actions as raw strings in positional tuples (1 form). + - GRANT and REVOKE SERVICE ROLE keep `!` as one raw name without a quoted flag + (2 forms). + - GRANT OWNERSHIP to a database role keeps `` in the object-kind string, case-folded + and without a quoted flag (1 form). + - Six docs pages changed after the catalogue pin (TASK_HISTORY, COMPLETE_TASK_GRAPHS, + CURRENT_TASK_GRAPHS, CREATE SECRET, CREATE NETWORK RULE, ALTER ICEBERG TABLE ... CONVERT TO + MANAGED). Their 16 forms keep the pinned grammar, so the new options have no obligations; 4 + of them are rejected on the changed grammar.