Another suggestion would be to clarify the use of "array" in the
specification -- maybe use "associative array" or "object" when you mean
{"key":"value"} and only "array" when you mean ["a", "b", "c"]; at least on
the first read of the spec this tripped me up and the example did not seem
to make much sense immediately. The API-lint had the same problem for a
while, though that seems to be fixed now.
Another suggestion would be to clarify the use of "array" in the specification -- maybe use "associative array" or "object" when you mean {"key":"value"} and only "array" when you mean ["a", "b", "c"]; at least on the first read of the spec this tripped me up and the example did not seem to make much sense immediately. The API-lint had the same problem for a while, though that seems to be fixed now.